Provides tools for managing Alibaba Cloud services including ECS (cloud servers), VPC (virtual private networks), RDS (relational databases), OSS (object storage), CloudMonitor (monitoring and alerts), and OOS (operations orchestration) through Alibaba Cloud APIs.
Alibaba Cloud Operations MCP Server
一个用于 Amazon Q CLI 的阿里云操作 MCP 服务器,支持 ECS、VPC、RDS、OSS、CloudMonitor、OOS 等服务。
English | 中文
系统要求
- Python 3.10+ (通过 uv 自动管理)
- uv - Python 包和项目管理器
- 阿里云访问凭证
快速开始
1. 安装 uv
2. 克隆项目
3. 一键安装
4. 配置环境变量
编辑 .env
文件:
5. 验证安装
如果看到 "Server is ready to accept connections." 说明安装成功。
Amazon Q CLI 配置
在 ~/.aws/amazonq/mcp.json
中添加以下配置:
重要提示: 将 /绝对路径/to/alicloud-ops-mcp
替换为项目的实际绝对路径。
配置示例
假设项目位于 /home/user/alicloud-ops-mcp
:
支持的服务
服务 | 功能 | 状态 |
---|---|---|
ECS | 云服务器管理、实例操作、镜像管理 | ✅ |
VPC | 虚拟私有云、网络配置、安全组 | ✅ |
RDS | 关系型数据库管理、备份恢复 | ✅ |
OSS | 对象存储、文件上传下载 | ✅ |
CloudMonitor | 云监控、告警管理、指标查询 | ✅ |
OOS | 运维编排、自动化任务 | ✅ |
开发说明
项目结构
使用 uv 进行开发
Python 版本管理
项目在 pyproject.toml
中指定了 Python 版本要求:
uv 会自动:
- 检测并安装合适的 Python 版本
- 创建隔离的虚拟环境
- 管理所有依赖关系
- 确保跨平台兼容性
故障排除
常见问题
1. Permission denied (os error 13)
原因: 配置错误或权限问题
解决方案:
2. Python 版本不兼容
错误信息: Could not find a version that satisfies the requirement fastmcp>=2.8.0
解决方案:
3. 依赖安装失败
解决方案:
4. 环境变量未加载
解决方案:
5. MCP 服务器无法启动
解决方案:
调试模式
启用详细日志:
验证配置
运行完整的环境检查:
性能优化
启动优化
内存优化
在 .env
文件中添加:
贡献指南
- Fork 项目
- 创建功能分支 (
git checkout -b feature/amazing-feature
) - 安装开发依赖 (
uv sync --dev
) - 运行测试 (
uv run pytest
) - 提交更改 (
git commit -m 'Add some amazing feature'
) - 推送到分支 (
git push origin feature/amazing-feature
) - 创建 Pull Request
开发环境设置
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
支持
如果遇到问题,请:
- 查看 故障排除 部分
- 运行
uv run python verify_setup.py
检查环境 - 查看 GitHub Issues
- 创建新的 Issue 报告问题
获取帮助
更新日志
v0.9.2 (2024-12-XX)
- ✨ 支持使用 uv 进行包管理
- 🚀 简化安装和配置流程
- 🐛 改进错误处理和调试信息
- 📚 更新文档和故障排除指南
- 🔧 添加环境验证脚本
- 📦 添加一键安装脚本
v0.9.1
- 🔧 修复依赖版本兼容性问题
- 📝 改进文档结构
- 🐛 修复环境变量加载问题
v0.9.0
- 🎉 初始版本发布
- ✅ 支持 ECS、VPC、RDS、OSS、CloudMonitor、OOS 服务
- 🔐 支持阿里云访问凭证配置
- 📖 完整的文档和示例
致谢
感谢所有贡献者和社区成员的支持!
⭐ 如果这个项目对你有帮助,请给个 Star!
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server for Amazon Q CLI that supports operations on Alibaba Cloud services including ECS, VPC, RDS, OSS, CloudMonitor, and OOS.
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your AWS environment. This allows for natural language querying and management of your AWS resources during conversations. Think of better Amazon Q alternative.Last updated -3280TypeScript
- -securityFlicense-qualityA management tool for Alibaba Cloud Message Service (MNS) implemented through the MCP framework, allowing users to create, delete, send messages to, and receive messages from MNS queues through MCP Host configuration.Last updated -Python
- AsecurityAlicenseAqualityA server that provides management and connectivity for Alibaba Cloud RDS database services via OpenAPI, enabling users to create, query, and modify RDS instances through MCP integration.Last updated -3230PythonApache 2.0
AlibabaCloud MCP Serverofficial
AsecurityAlicenseAqualityA server that provides access to Alibaba Cloud resources including ECS, VPC, and CloudMonitor through API and OOS implementations, enabling resource management and monitoring via a unified interface.Last updated -3463PythonApache 2.0