Rundeck MCP 服务器

这是一个用于与 Rundeck CLI 交互的模型上下文协议 (MCP) 服务器。 它提供了一组工具，允许您使用 AI 执行 Rundeck 操作，而无需直接与命令行交互。

功能

• 作业管理: 列出、获取信息、执行和预测
• 执行管理: 列出、获取信息、获取输出和跟踪
• 项目管理: 列出和获取信息
• 节点和系统信息: 列出节点和获取系统信息

安装

前提条件

• Node.js (v14 或更高版本)
• Rundeck CLI 工具

步骤

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 Desktop 以使设置生效。

如何安装 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