Rundeck Mcp Server

io.github.mariomorenodev由 GitHub 账号 mariomorenodev 发布v1.0.3更新于 Oct 24, 2026

50 tools to manage Rundeck jobs, executions, projects, nodes, and system via MCP

已验证STDIO仅桌面云端与基础设施开发者工具安全与监控

概览

AI 生成的概览

一个本地 MCP 服务器，让助手管理 Rundeck 实例：项目、作业、执行、节点、系统设置、密钥存储、Webhook 和 ACL 策略。

可以做什么
列出、创建、删除和配置项目及其配置属性，并按过滤表达式浏览节点、查看节点详情。列出、查看、运行、重试、导入、导出、删除和批量删除作业，启用或停用作业执行与调度，并预测即将到来的运行时间。查询执行历史与正在运行的执行，读取执行详情和日志输出，中止运行中的执行，并单个或批量删除执行。读取服务器信息、健康状态、指标、执行模式、用户和日志存储，并在系统范围内切换执行模式。管理 ACL 策略和 Webhook，浏览、创建和删除已存储的密钥，但只能读取密钥元数据。
适用场景
适合已经用 Rundeck 做作业调度和部署自动化、希望用对话方式操作它的场景：查看正在运行的任务、拉取日志、启动或重试作业，以及不打开网页界面就调整调度、项目或策略。
运行要求
通过 npx 在本地运行，需要 Node.js 18 或更高版本。需要一个可访问且开放 API 的 Rundeck 实例和 Rundeck API 令牌。需设置 RUNDECK_URL 和 RUNDECK_API_TOKEN；RUNDECK_API_VERSION（默认 41）和 RUNDECK_TIMEOUT（默认 30000 毫秒）为可选项。
安装前请注意
该 API 令牌赋予助手对应 Rundeck 账号的全部权限，且许多工具会修改或销毁状态：删除项目、作业、执行、密钥、Webhook 和 ACL 策略，中止运行，以及全系统切换执行模式。密钥存储工具可创建和删除机密、密码和 SSH 密钥。建议先连接非生产实例，并使用最小权限的令牌。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Rundeck Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

rundeck-mcp-server

[npm version] [License]

The most comprehensive MCP (Model Context Protocol) server for Rundeck. Manage jobs, executions, projects, nodes, and more from Claude, Cursor, or any MCP-compatible client.

50 tools across 7 domains — full CRUD operations, execution monitoring, and system management.

Features

  • Projects — List, create, delete, and configure projects
  • Jobs — List, create, run, retry, import/export, enable/disable execution and scheduling
  • Executions — Monitor running jobs, get logs, abort executions, query history
  • Nodes — Browse node inventory with filter expressions
  • System — Server info, health checks, metrics, execution mode control
  • Key Storage — Manage secrets, passwords, and SSH keys
  • Webhooks — Create and manage webhook triggers
  • ACL Policies — Full CRUD for system access control policies

Quick Start

Prerequisites

Using with Claude Code

Add to your MCP settings:

json
{  "mcpServers": {    "rundeck": {      "command": "npx",      "args": ["-y", "rundeck-mcp-server"],      "env": {        "RUNDECK_URL": "http://your-rundeck-server:4440",        "RUNDECK_API_TOKEN": "your-api-token"      }    }  }}

Using with Claude Desktop

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "rundeck": {      "command": "npx",      "args": ["-y", "rundeck-mcp-server"],      "env": {        "RUNDECK_URL": "http://your-rundeck-server:4440",        "RUNDECK_API_TOKEN": "your-api-token"      }    }  }}

Using with Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

json
{  "mcpServers": {    "rundeck": {      "command": "npx",      "args": ["-y", "rundeck-mcp-server"],      "env": {        "RUNDECK_URL": "http://your-rundeck-server:4440",        "RUNDECK_API_TOKEN": "your-api-token"      }    }  }}

Configuration

Environment VariableRequiredDefaultDescription
RUNDECK_URLYes—Rundeck server URL (e.g., http://localhost:4440)
RUNDECK_API_TOKENYes—API token for authentication
RUNDECK_API_VERSIONNo41Rundeck API version
RUNDECK_TIMEOUTNo30000Request timeout in milliseconds

Available Tools

Projects (6 tools)

ToolDescription
rundeck_list_projectsList all projects
rundeck_get_projectGet project details and configuration
rundeck_create_projectCreate a new project
rundeck_delete_projectDelete a project permanently
rundeck_get_project_configGet project configuration properties
rundeck_set_project_configUpdate project configuration

Jobs (14 tools)

ToolDescription
rundeck_list_jobsList jobs with filtering by group, name, tags
rundeck_get_jobGet full job definition (steps, options, schedule)
rundeck_get_job_metadataGet job metadata (author, dates)
rundeck_run_jobExecute a job with options and node filters
rundeck_retry_jobRetry a failed execution
rundeck_import_jobsImport jobs from JSON/YAML/XML
rundeck_export_jobsExport job definitions
rundeck_delete_jobDelete a job
rundeck_bulk_delete_jobsDelete multiple jobs at once
rundeck_enable_job_executionEnable job execution
rundeck_disable_job_executionDisable job execution
rundeck_enable_job_scheduleEnable job scheduling
rundeck_disable_job_scheduleDisable job scheduling
rundeck_get_job_forecastGet upcoming scheduled execution times

Executions (8 tools)

ToolDescription
rundeck_list_executionsQuery executions with status and time filters
rundeck_list_running_executionsList currently running executions
rundeck_get_executionGet execution details (status, duration, nodes)
rundeck_get_execution_outputGet execution log output
rundeck_abort_executionAbort a running execution
rundeck_get_job_executionsList execution history for a job
rundeck_delete_job_executionsDelete all executions for a job
rundeck_bulk_delete_executionsDelete multiple executions by ID

Nodes (2 tools)

ToolDescription
rundeck_list_nodesList nodes with filter expressions
rundeck_get_nodeGet node details

System (12 tools)

ToolDescription
rundeck_system_infoServer version, uptime, and system stats
rundeck_get_execution_modeCheck active/passive execution mode
rundeck_set_execution_modeEnable or disable executions system-wide
rundeck_get_metricsServer performance metrics
rundeck_healthcheckSystem health check
rundeck_list_usersList all users
rundeck_get_log_storageLog storage status
rundeck_list_acl_policiesList ACL policy files
rundeck_get_acl_policyGet ACL policy content
rundeck_create_acl_policyCreate ACL policy
rundeck_update_acl_policyUpdate ACL policy
rundeck_delete_acl_policyDelete ACL policy

Key Storage (4 tools)

ToolDescription
rundeck_list_keysBrowse key storage tree
rundeck_get_key_metadataGet key metadata (not the secret value)
rundeck_create_keyStore a password, public key, or private key
rundeck_delete_keyDelete a stored key

Webhooks (4 tools)

ToolDescription
rundeck_list_webhooksList webhooks in a project
rundeck_get_webhookGet webhook details
rundeck_create_webhookCreate a webhook trigger
rundeck_delete_webhookDelete a webhook

Usage Examples

Once configured, you can interact with Rundeck using natural language:

  • "List all projects in Rundeck"
  • "Show me the running executions in the production project"
  • "Run the deploy-app job in the staging project with version=2.1.0"
  • "Get the logs from execution 1234"
  • "Abort execution 5678"
  • "Show me all failed executions in the last 24 hours"
  • "List the nodes tagged as 'web' in the production project"
  • "Check the Rundeck server health"
  • "Disable the cleanup job schedule"

Development

bash
# Clone the repositorygit clone https://github.com/mariomorenodev/rundeck-mcp-server.gitcd rundeck-mcp-server
# Install dependenciesnpm install
# Buildnpm run build
# Run in development modeRUNDECK_URL=http://localhost:4440 RUNDECK_API_TOKEN=your-token npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

来源：README.md，提交 1a03b0e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分