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 许可证。