aliyun/alibabacloud-api-mcp-server
If you are the rightful owner of alibabacloud-api-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Alibaba Cloud API MCP Server is a robust platform designed to facilitate seamless communication and integration between various cloud services and applications using the Model Context Protocol (MCP).
阿里云 MCP Server 使用指南
📚 目录
概述
阿里云 MCP Server 是一个强大的云服务集成平台，通过 Model Context Protocol (MCP) 为 AI 应用提供阿里云服务的无缝集成能力。该平台支持数万个阿里云 OpenAPI，让开发者能够轻松地将阿里云的各种服务能力集成到 AI 工作流中。
部署模式
远程模式
通过阿里云官方托管的 OpenAPI MCP Server，无需本地部署即可使用全量阿里云服务。适合快速集成、低维护成本的场景。
本地模式
基于 stdio 进程模式，在本地运行 MCP Server。适合对数据安全性要求高、需要自定义配置的场景。
远程模式详解
技术规格
- 支持协议：SSE (Server-Sent Events)、Streamable HTTP
- 认证方式：OAuth 2.0
- API 数量：支持阿里云数万个 OpenAPI
- 部署方式：云端托管，零运维
访问地址
| 区域 | 访问地址 | 适用场景 |
|---|---|---|
| 中国站 | https://api.aliyun.com/mcp | 中国大陆用户 |
| 国际站 | https://api.alibabacloud.com/mcp | 海外及国际用户 |
系统 MCP 服务列表
阿里云官方提供了一系列经过精心调优的系统 MCP 服务，针对特定场景进行了优化：
基础设施管理
| 服务名称 | 功能描述 |
|---|---|
| Terraform Provider | 提供阿里云 Terraform Provider 元数据，支持在线验证和执行 Terraform 命令的 Runtime 能力 |
| 配额中心 | 根据云产品名称、配额描述、地域信息等，查询配额中心支持的产品通用配额信息 |
| 资源搜索 | 支持当前账号下有权限资源的搜索和统计功能 |
监控与审计
| 服务名称 | 功能描述 |
|---|---|
| 操作审计 AI | 使用 AI 根据场景灵活调用操作审计的 LookupEvents 接口 |
| 权限诊断 | API 请求因无权限被拒绝时，通过 EncodedDiagnosticMessage 进行权限诊断 |
合规与治理
| 服务名称 | 功能描述 |
|---|---|
| 治理报告 | 基于 GovernanceReport 的 MCP Server |
| 配置审计合规包 | 查询合规包模板、启用指定合规包、查询风险项概况及风险资源清单 |
核心能力
OpenAPI 定制化调优
- 修改 API 描述，使其更适合 AI 理解
- 精简非必填参数，降低调用复杂度
- 优化参数说明，提高 AI 调用准确率
Terraform As Tools
- HCL 代码集成：将 Terraform HCL 代码作为完整工具引入
- 变量自动解析：Terraform 变量自动转换为工具参数
- 确定性编排：实现基础设施的确定性部署和管理
多账号支持
- 角色扮演：自动使用角色扮演能力操作特定账号
- 账号切换：灵活指定操作账号和扮演角色
- 集中管理：轻松实现多账号 AI 集成管理
自定义 OAuth
- Callback 白名单：精确控制回调地址白名单
- Token 生命周期：灵活设置 access token 和 refresh token 过期时间
- 长期免登录：最长可实现 1 年免登录
本地模式详解
运行机制
本地模式基于 stdio 进程通信，MCP Server 作为独立进程在本地运行，通过标准输入输出与 AI 应用进行通信。
服务列表
数据库服务
| 服务 | 仓库地址 | 描述 |
|---|---|---|
| DMS | alibabacloud-dms-mcp-server | 数据管理服务，提供数据库管理能力 |
| RDS | alibabacloud-rds-openapi-mcp-server | 关系型数据库服务 OpenAPI 集成 |
| ADBPG | alibabacloud-adbpg-mcp-server | 分析型数据库 PostgreSQL 版 |
数据分析服务
| 服务 | 仓库地址 | 描述 |
|---|---|---|
| DataWorks | alibabacloud-dataworks-mcp-server | 数据工场，提供大数据开发治理能力 |
DevOps 服务
| 服务 | 仓库地址 | 描述 |
|---|---|---|
| 云效 | alibabacloud-devops-mcp-server | 企业级 DevOps 平台集成 |
| 运维开发 | alibaba-cloud-ops-mcp-server | 运维开发工具集成 |
其他服务
| 服务 | 仓库地址 | 描述 |
|---|---|---|
| ESA | mcp-server-esa | 边缘安全加速服务 |
| 可观测 | alibabacloud-observability-mcp-server | 可观测性服务集成 |
快速开始
远程模式接入
-
访问控制台
- 中国站用户访问：https://api.aliyun.com/mcp
- 国际站用户访问：https://api.alibabacloud.com/mcp
-
OAuth 认证
- 配置 OAuth 应用
- 获取 Access Token
- 配置 Token 刷新策略
-
选择服务
- 浏览系统 MCP 服务
- 选择需要的 OpenAPI
- 自定义 API 参数
本地模式部署
-
克隆仓库
git clone https://github.com/aliyun/[具体服务仓库名称] cd [仓库目录] -
安装依赖
npm install # 或 yarn install -
配置认证
export ALIBABA_CLOUD_ACCESS_KEY_ID=your_access_key export ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_secret_key -
启动服务
npm start # 或按照具体仓库的启动说明
参考文档
- 📖 官方文档：OpenAPI MCP Server 使用指南
- 🔧 技术支持：通过阿里云工单系统或官方论坛获取技术支持
- 💬 社区交流：加入阿里云开发者社区参与讨论，钉钉群：136325002292
本文档持续更新中，欢迎提交 Issue 或 PR 贡献内容