阿里云API-MCP服务器
项目介绍
阿里云MCP服务器用户指南
英文README
📚 目录
概览
阿里云MCP服务器是一个强大的云服务集成平台，通过模型上下文协议（MCP）提供无缝集成阿里云服务的能力，适用于AI应用。该平台支持数万个阿里云OpenAPI，使开发者能够轻松地将各种阿里云服务能力整合到AI工作流中。
部署模式
远程模式
通过阿里云官方托管的OpenAPI MCP服务器，您可以无需本地部署即可访问完整的阿里云服务，非常适合需要快速集成且维护成本低的场景。
本地模式
在本地以stdio进程模式运行MCP服务器。适合对数据安全有高要求且需要自定义配置的场景。
远程模式详情
技术规格
- 支持协议SSE（服务器发送事件），可流式HTTP
- 认证方法OAuth 2.0
- API数量支持数万个阿里云OpenAPI
- 部署方式云托管，零维护
访问地址
| 区域 | 访问地址 | 适用场景 |
|---|---|---|
| 中国站 中国大陆用户 | https://api.aliyun.com/mcp | |
| 国际站 | https://api.alibabacloud.com/mcp | 海外及国际用户 |
系统MCP服务列表
阿里云官方提供了一系列精心优化的系统MCP服务，针对特定场景进行了定制：
基础设施管理
| 服务名称 | 功能描述 |
|---|---|
| Terraform Provider | 提供阿里云Terraform Provider元数据，支持在线验证和执行Terraform命令的运行时能力 |
| 配额中心 根据云产品名称、配额描述、区域信息等查询配额中心支持的产品通用配额信息 | |
| 资源搜索 支持授权资源下的搜索和统计功能 |
监控与审计
| 服务名称 | 功能描述 |
|---|---|
| 操作审计AI 使用AI灵活调用LookupEvents接口进行操作审计 | |
| 权限诊断 当因缺乏权限导致API请求被拒绝时，通过EncodedDiagnosticMessage进行权限诊断 |
合规与治理
| 服务名称 | 功能描述 |
|---|---|
| 治理报告 基于GovernanceReport的MCP服务器 | |
| 配置合规性包 查询合规性包模板，启用指定的合规性包，查询风险项概览和风险资源列表 |
核心能力
OpenAPI定制调优
- 修改API描述使其更适合AI理解
- 简化非必填参数以减少调用复杂度
- 参数优化解释以提高AI调用准确性
Terraform作为工具
- HCL代码集成引入Terraform HCL代码作为完整工具
- 自动变量解析Terraform变量自动转换为工具参数
- 确定性编排实现基础设施的确定性部署和管理
多账号支持
- 角色扮演自动使用角色扮演能力操作特定账号
- 账号切换灵活指定操作账号和要承担的角色
- 集中管理轻松实现多账号AI集成管理
自定义OAuth
- 回调白名单精确控制回调地址白名单
- 令牌生命周期灵活设置访问令牌和刷新令牌的过期时间
- 长期无登录最长可达1年的无登录访问
本地模式详解
运行机制
本地模式基于stdio进程通信，MCP服务器作为一个独立进程在本地运行，并通过标准输入输出与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服务
| 服务 | 仓库地址 | 描述 |
|---|---|---|
| Yunxiao | 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服务器用户指南
- 🔧 技术支持通过阿里云工单系统或官方论坛获取技术支持
- 💬 社区交流加入阿里云开发者社区参与讨论。钉钉群：136325002292
- 使用示例AgentScopehttps://github.com/agentscope-ai/agentscope/tree/main/examples/alibabacloud_api_mcp
本文件持续更新。欢迎通过Issues或PR贡献