内容
# Rundeck MCP 服务器
这是一个用于与 Rundeck CLI 交互的模型上下文协议（MCP）服务器。它提供了一组工具，允许您在不直接与命令行交互的情况下使用 AI 执行 Rundeck 操作。
## 功能特点
- **作业管理**：列出、获取信息、执行和预测
- **执行管理**：列出、获取信息、获取输出和跟踪
- **项目管理**：列出和获取信息
- **节点和系统信息**：列出节点和获取系统信息
## 安装
### 前提条件
- Node.js（v14 或更高版本）
- Rundeck CLI 工具
### 步骤
1. 克隆此仓库：
```bash
git clone https://github.com/vanisoul/rundeck-mcp-server
cd rundeck-mcp-server
```
2. 安装依赖项：
```bash
npm install
```
3. 构建项目：
```bash
npm run build
```
4. 配置 MCP 设置文件：
将以下配置添加到您的 MCP 设置文件中。设置文件的路径取决于您的环境：
```json
{
"mcpServers": {
"rundeck": {
"command": "node",
"args": ["/path/to/rundeck-mcp-server/build/index.js"],
"env": {
"RUNDECK_CLI_PATH": "/usr/bin/rd",
"RUNDECK_BASE_URL": "http://您的-rundeck-服务器:端口/",
"RUNDECK_API_TOKEN": "您的-api-token"
},
"disabled": false,
"alwaysAllow": []
}
}
}
```
请确保替换以下值：
- `/path/to/rundeck-mcp-server/build/index.js`：已构建的 index.js 文件的绝对路径
- `/usr/bin/rd`：Rundeck CLI 工具的绝对路径
- `http://您的-rundeck-服务器:端口/`：您的 Rundeck 服务器 URL
- `您的-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
