Rundeck MCP Server

Rundeck MCP Server

site icon
2025.04.16 0
JavaScript自动化工具运维工具开发效率
Rundeck MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于与 Rundeck CLI 进行交互。它提供了一套工具,允许用户通过 AI 间接执行 Rundeck 操作,而无需直接使用命令行。
View on GitHub

Overview

基本能力

产品定位

Rundeck MCP Server 旨在简化 Rundeck 操作流程,通过 AI 接口提供对 Rundeck 的管理能力,适合需要自动化或简化 Rundeck 操作流程的开发者和运维人员。

核心功能

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

适用场景

  • 自动化 Rundeck 作业管理
  • 集成 Rundeck 功能到其他应用或服务中
  • 通过 AI 简化复杂的 Rundeck 操作流程

工具列表

  • Rundeck CLI 工具:用于与 Rundeck 服务器进行交互

常见问题解答

  1. 确保 Rundeck CLI 工具可用且正常工作
  2. 检查 RUNDECK_CLI_PATH 环境变量是否指向正确的 Rundeck CLI 工具路径
  3. 确认 RUNDECK_BASE_URL 和 RUNDECK_API_TOKEN 环境变量设置正确
  4. 验证 MCP 设置文件配置是否正确

使用教程

使用依赖

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

安装教程

  1. 克隆仓库:
git clone https://github.com/vanisoul/rundeck-mcp-server
cd rundeck-mcp-server
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build
  1. 配置 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": []
    }
  }
}
  1. 重启 VS Code 或 Claude Desktop 使设置生效

调试方式

  • 确保所有环境变量和路径配置正确
  • 检查 Rundeck CLI 工具是否正常工作
  • 验证 MCP 设置文件是否正确配置

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。