Argocd MCP

🚀 ArgoCD MCP サーバー

ArgoCD MCP サーバーは、アプリケーションの配信と管理を支援するツールです。このサーバーを使用することで、アプリケーションの管理や同期を効率的に行うことができます。

🚀 クイックスタート

📦 インストール

リポジトリのクローン

git clone https://github.com/akuity/argocd-mcp.git
cd argocd-mcp

プロジェクトの依存関係のインストール

pnpm install

開発サーバーの起動（ホットリロード付き）

# SSE モードを使用してホットリロードを有効にする
pnpm run dev

起動後、Visual Studio Code やその他の MCP クライアントでこのサーバーを使用できます。

⚙️ 設定

Cursor を使用する場合

1. Cursor ドキュメントの MCP サポートを参照して、プロジェクトディレクトリ内に .cursor/mcp.json ファイルを作成します。

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. Agent モードでセッションを開始します。

Visual Studio Code を使用する場合

1. VSCode の MCP サポートに関するドキュメントを参照して、プロジェクトディレクトリ内に .vscode/mcp.json ファイルを作成します。

{
  "servers": {
    "argocd-mcp-stdio": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. MCP をサポートする VS Code でセッションを開始します。

Claude Desktop を使用する場合

1. Claude Desktop ドキュメントの MCP サポートを参照して、設定ファイル claude_desktop_config.json を作成します。

{
  "mcpServers": {
    "argocd-mcp": {
      "command": "npx",
      "args": [
        "argocd-mcp@latest",
        "stdio"
      ],
      "env": {
        "ARGOCD_BASE_URL": "<argocd_url>",
        "ARGOCD_API_TOKEN": "<argocd_token>"
      }
    }
  }
}

2. Claude Desktop の設定でこの設定ファイルを指定します。

💻 使用例

利用可能なツール

アプリケーション管理

• list_applications：すべてのアプリケーションをリストし、フィルタリングします。
• get_application：特定のアプリケーションの詳細情報を取得します。
• create_application：新しいアプリケーションを作成します。
• update_application：既存のアプリケーションを更新します。
• delete_application：アプリケーションを削除します。
• sync_application：アプリケーションの同期をトリガーします。

リソース管理

• get_application_resource_tree：特定のアプリケーションのリソースツリーを取得します。
• get_application_managed_resources：アプリケーションが管理するリソースを取得します。
• get_application_deployment：アプリケーションのデプロイ情報を取得します。
• update_application_deployment：アプリケーションのデプロイ構成を更新します。

🔧 アップデートと再構築

ArgoCD 依存関係の更新

プロジェクト内の argocd 依存関係を最新バージョンに更新するには、次のコマンドを実行します。

pnpm update argocd

プロジェクトの再構築

pnpm build

📤 コードのコミットとプッシュ

git add .
git commit -m "your_commit_message"
git push

📚 用語集

• MCP：Model Context Protocol（モデルコンテキストプロトコル）
• ArgoCD：アプリケーションの配信と管理を行うためのツール