MCP Server 3ey

🚀 Pulumi MCP サーバー

この MCP サーバーは現在積極的に開発中です。その API（利用可能なコマンドとそのパラメータを含む）は実験的な段階にあり、事前通知なしに破壊的な変更が導入される可能性があります。問題が発生した場合や、他の Pulumi コマンドのサポートが必要な場合は、GitHub で問題を報告してください。

このサーバーは、モデルコンテキストプロトコル (MCP) を実装し、Pulumi 自動化 API と Pulumi クラウド API を通じて Pulumi CLI とやり取りするためのものです。

このパッケージを使用すると、MCP クライアントはクライアント環境に直接 Pulumi CLI をインストールすることなく、パッケージ情報の取得、変更のプレビュー、更新のデプロイ、スタック出力の取得などの Pulumi 操作を実行できます。

🚀 クイックスタート

💻 使用例

基本的な使用法

Pulumi CLI をお使いのマシンにインストールする必要があります。

このパッケージは主に、MCP を使用できるアプリケーションに MCP サーバーを統合するために使用されます。例えば、以下はClaude デスクトップの MCP 設定ファイルに Pulumi MCP サーバーを含める方法です。

{
  "mcpServers": {
    "pulumi": {
      "command": "npx",
      "args": ["@pulumi/mcp-server@latest"]
    }
  }
}

高度な使用法

Pulumi MCP サーバーを Docker コンテナとして実行することもできます。この方法では、ホストマシンに直接 Node.js とパッケージの依存関係をインストールする必要がなくなります。

コンテナのビルド

コンテナをビルドするには、次のコマンドを実行します。

docker build -t pulumi/mcp-server:latest .

MCP クライアントとの併用

コンテナ化されたサーバーを MCP クライアントと一緒に使用するには、クライアントを Docker コンテナを使用するように設定する必要があります。例えば、Claude デスクトップの MCP 設定では、次のようにします。

{
  "mcpServers": {
    "pulumi": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "pulumi/mcp-server:latest"]
    }
  }
}

ローカルの Pulumi プロジェクトディレクトリにアクセスする必要がある Pulumi 操作の場合は、適切なディレクトリをマウントする必要があります。例えば、Pulumi プロジェクトが ~/projects/my-pulumi-app にある場合、次のように設定します。

{
  "mcpServers": {
    "pulumi": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", "~/projects/my-pulumi-app:/app/project", "pulumi/mcp-server:latest"]
    }
  }
}

その後、MCP ツールを使用する際には、プロジェクトディレクトリを /app/project として参照する必要があります。

🔧 利用可能なコマンド

サーバーは、以下の Pulumi 操作のハンドルを処理し、MCP リクエストを通じて呼び出すことができます。

• preview: pulumi preview を実行します。
  • 新しいインフラストラクチャ操作の結果を表示します。
• up: pulumi up を実行します。
  • 新しいリソースと変更されたリソースをデプロイします。
• down: pulumi down を実行します。
  • すべてのリソースを削除します。
• destroy: pulumi destroy を実行します。
  • すべてのリソースを破棄します。
• introspect: pulumi introspect を実行します。
  • 現在のスタックの状態を表示します。
• validate: pulumi validate を実行します。
  • 設定が有効で使用できることを検証します。

🔨 開発手順

1. リポジトリをクローンします。
2. 依存関係をインストールします: make ensure
3. プロジェクトをビルドします: make build
4. プロジェクトをテストします: make test

📄 ライセンス

このプロジェクトは Apache-2.0 ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

⚠️ 重要提示

この MCP サーバーは現在積極的に開発中です。その API（利用可能なコマンドとそのパラメータを含む）は実験的な段階にあり、事前通知なしに破壊的な変更が導入される可能性があります。問題が発生した場合や、他の Pulumi コマンドのサポートが必要な場合は、GitHub で問題を報告してください。