Capi MCP

🚀 CAPI MCP Server

CAPI MCP Serverは、Kubernetes Cluster API (CAPI) 用の本格的なモデルコンテキストプロトコル (MCP) サーバーです。これにより、AIエージェントは安全で標準化されたインターフェースを介してKubernetesクラスタを管理することができます。

🚀 クイックスタート

CAPI MCP Serverは、AIエージェント（MCPクライアント）とCAPI管理クラスタの間の架け橋として機能します。これは、CAPIの複雑さを抽象化し、クラスタのライフサイクル管理を簡単で信頼性の高い操作に変える一連のツールを提供します。

✨ 主な機能

V1.0 Scope

• インフラストラクチャプロバイダー: AWS (Cluster API Provider for AWS - CAPA 経由)
• コアツール:
  • list_clusters - 管理されているすべてのワークロードクラスタをリストする
  • get_cluster - 特定のクラスタの詳細情報を取得する
  • create_cluster - テンプレートから新しいワークロードクラスタを作成する
  • delete_cluster - ワークロードクラスタを削除する
  • scale_cluster - クラスタ内のワーカーノードをスケーリングする
  • get_cluster_kubeconfig - クラスタのアクセス資格情報を取得する
  • get_cluster_nodes - クラスタ内のノードをリストする
• セキュリティ: APIキー認証、RBAC、シークレット管理
• オブザーバビリティ: 構造化ロギング、Prometheusメトリクス

🔧 技術詳細

サーバーは、モジュール式で拡張可能な設計に則っています。

• MCPとCAPIを橋渡しするための Proxy/Gateway Pattern
• 将来的なマルチクラウドサポートのための Provider Interface
• 長時間実行されるCAPI操作の 非同期処理
• 最小限の特権アクセスによる セキュリティファースト のアプローチ

詳細な設計ドキュメントについては、architecture.md を参照してください。

📦 インストール

前提条件

• Go 1.24.x
• Docker & Docker Compose
• kubectl
• kind (ローカルテスト用)
• golangci-lint

クイックスタート

# リポジトリをクローンする
git clone https://github.com/capi-mcp/capi-mcp-server.git
cd capi-mcp-server

# 依存関係をインストールする
make deps

# 開発ツールをインストールする
make tools

# テストを実行する
make test

# サーバーをビルドする
make build

# ローカルで実行する (API_KEY 環境変数が必要)
API_KEY=your-key make run

プロジェクト構造

/capi-mcp-server
├── /api/v1           # MCPツール/リソースのスキーマ
├── /cmd/server       # アプリケーションのエントリポイント
├── /internal         # 非公開のアプリケーションコード
│   ├── /server       # MCPサーバーエンジン
│   ├── /service      # ビジネスロジック
│   ├── /kube         # CAPIクライアントラッパー
│   └── /config       # 設定
├── /pkg              # 公開ライブラリ
│   ├── /provider     # プロバイダーインターフェース
│   └── /tools        # ツールの実装
├── /deploy           # デプロイメントアーティファクト
├── /test             # テストスイート
└── /docs             # ドキュメント

🚀 デプロイメント

サーバーは、Helmを使用してKubernetesワークロードとしてデプロイされます。

helm install capi-mcp-server ./deploy/charts/capi-mcp-server \
  --set auth.apiKey=$API_KEY \
  --namespace capi-system

🔐 セキュリティ

• 認証: APIキーベース (Bearerトークン)
• 承認: 最小限の特権を持つKubernetes RBAC
• ネットワーク: NetworkPoliciesで制限されている
• シークレット: ログに記録されることはなく、安全に取り扱われる

🤝 コントリビュート

開発ガイドラインと標準については、CLAUDE.md を読んでください。

🗺️ ロードマップ

プロジェクトのビジョンと開発フェーズについては、roadmap.md を参照してください。

📄 ライセンス

[ライセンスの詳細は後日追加予定]

⚠️ 重要提示

このリポジトリは、主にAnthropicのAIアシスタントであるClaude Codeが人間の開発者と協力して作成されました。コード、ドキュメント、テスト、および全体的なアーキテクチャは、AI支援開発セッションを通じて生成されました。 コードは業界のベストプラクティスに従っており、包括的なテストが含まれていますが、ユーザーは以下のことを行う必要があります。

• 本番環境にデプロイする前にすべてのコードをレビューする
• 実装のセキュリティ上の影響を理解する
• コードが彼らの特定の要件とコンプライアンス基準を満たしていることを検証する
• 重要なシステムにおけるAI生成コードの実験的な性質を考慮する