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