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 分