Codemagic MCP Server

---

---

Codemagic CI/CD API にシームレスにアクセスできる、軽量でコミュニティが保守する Model Context Protocol (MCP) サーバーです。エージェント、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