MCP Server 3ey

🚀 Pulumi MCP 服務器

Pulumi MCP 服務器是一個實現 模型上下文協議 (MCP) 的服務器，可通過 Pulumi 自動化 API 和 Pulumi 雲 API 與 Pulumi CLI 進行交互。它允許 MCP 客戶端在不直接安裝 Pulumi CLI 的情況下，執行諸如檢索包信息、預覽更改、部署更新和檢索堆棧輸出等操作。

⚠️ 重要提示

當前正在積極開發此 MCP 服務器。其 API（包括可用命令及其參數）處於實驗階段，可能會在沒有通知的情況下引入破壞性更改。如果您遇到問題或需要支持其他 Pulumi 命令，請在 GitHub 上報告問題。

🚀 快速開始

使用 Pulumi MCP 服務器前，必須在您的機器上安裝 Pulumi CLI。此包主要用於將 MCP 服務器集成到可以使用 MCP 的應用程序中。

集成到應用程序

以下是如何在 Claude 桌面的 MCP 配置文件中包含 Pulumi MCP 服務器：

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

Docker 容器方式

您還可以將 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 文件。