Codemagic MCP Server

---

---

一款轻量级、由社区维护的 Model Context Protocol（MCP） 服务，可无缝访问 Codemagic CI/CD API。专为 Agent、AI 原生工作流以及兼容 MCP 的客户端打造。

---

🌐 使用方式

你： 我在 Codemagic 上有哪些应用？
助手： 调用 get_all_applications() 并显示列表。

你： 为我的 Flutter 应用启动一次新构建
助手： 使用相应参数调用 start_build()

你： 能获取我上次构建的构件吗？
助手： 调用 get_builds() 查找最新构建，然后调用 get_artifact() 下载文件

你： 显示我的应用的缓存使用情况
助手： 调用 get_app_caches() 并显示存储信息

---

🌐 开始使用

1. 克隆此仓库

git clone https://github.com/stefanoamorelli/codemagic-mcp.git
cd codemagic-mcp

2. 设置 API 密钥

请参阅官方文档。

3. 在客户端中安装 MCP 服务

例如，适用于 Claude Desktop：

{
  "mcpServers": {
    "Codemagic MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "<global_path_to_the_cloned_repo>/codemagic_mcp/server.py"
      ],
      "env": {
        "PYTHONPATH": "<global_path_to_the_cloned_repo>/",
        "CODEMAGIC_API_KEY": "your-api-key-here"
      }
    },
}

---

📈 此服务的功能

使用自然语言与 Codemagic CI/CD 交互。

API 类别	工具
应用 API	get_all_applications、get_application、add_application、add_application_private
构件 API	get_artifact、create_public_artifact_url
构建 API	start_build、get_builds、get_build_status、cancel_build、get_build_step_log
缓存 API	get_app_caches、delete_all_app_caches、delete_app_cache
团队 API	invite_team_member、delete_team_member

---

🛠️ 开发

在本地运行服务以进行测试：

mcp dev codemagic_mcp/server.py

---

📚 参考资料

• Codemagic REST API 文档
• Model Context Protocol 文档
• Python MCP SDK

---

📜 许可证

MIT 许可证 © 2025 Stefano Amorelli