Rundeck MCP Server

🚀 Rundeck MCP 服務器

這是一個用於與 Rundeck CLI 交互的模型上下文協議（MCP）服務器。它提供了一系列工具，讓您無需直接與命令行交互，就能通過 AI 進行 Rundeck 操作，極大提升了操作的便捷性。

✨ 主要特性

• 作業管理：可對作業進行列出、獲取信息、執行和預測等操作。
• 執行管理：支持列出、獲取信息、獲取輸出和跟蹤執行情況。
• 項目管理：能夠列出項目並獲取項目信息。
• 節點和系統信息：可列出節點並獲取系統相關信息。

📦 安裝指南

先決條件

• Node.js（v14 或更高版本）
• Rundeck 命令行界面工具

步驟

1. 克隆此倉庫：

git clone https://github.com/vanisoul/rundeck-mcp-server
cd rundeck-mcp-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 配置 MCP 設置文件： 將以下配置添加到您的 MCP 設置文件中。設置文件的位置取決於您的環境。

{
  "mcpServers": {
    "rundeck": {
      "command": "node",
      "args": ["/path/to/rundeck-mcp-server/build/index.js"],
      "env": {
        "RUNDECK_CLI_PATH": "/usr/bin/rd",
        "RUNDECK_BASE_URL": "http://your-rundeck-server:port/",
        "RUNDECK_API_TOKEN": "your-api-token"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

請確保替換以下值：

• /path/to/rundeck-mcp-server/build/index.js：構建的 index.js 文件的絕對路徑
• /usr/bin/rd：Rundeck CLI 工具的絕對路徑
• http://your-rundeck-server:port/：您的 Rundeck 服務器 URL
• your-api-token：您的 Rundeck API 令牌

5. 重新啟動 VS Code 或 Claude 桌面以使設置生效。

如何安裝 Rundeck CLI

• https://docs.rundeck.com/docs/rd-cli/install.html

📚 詳細文檔

故障排除

如果遇到問題，請檢查以下內容：

1. 確保 Rundeck CLI 工具正常可用並工作。
2. 確保 RUNDECK_CLI_PATH 環境變量指向正確的 Rundeck CLI 工具路徑。
3. 確保 RUNDECK_BASE_URL 和 RUNDECK_API_TOKEN 環境變量設置正確。
4. 檢查 MCP 設置文件是否配置正確。

📄 許可證

本項目採用 MIT 許可證。