mcpField
R
Rundeck MCP Server

Rundeck MCP Server

Local
github.com/vanisoulCloud & Infra3Updated 80w ago
Repository

About Rundeck MCP Server

Rundeck MCP Server exposes Rundeck operations through tools backed by the Rundeck CLI. It is for users who want to manage jobs, executions, projects, nodes, and system information through an MCP client rather than issuing CLI commands directly.

Key features

  1. 01List and inspect jobs
  2. 02Execute and predict jobs
  3. 03List and inspect executions
  4. 04View execution output and track status
  5. 05Inspect projects, nodes, and system information

Use cases

  1. 01Check job details before execution
  2. 02Launch and monitor Rundeck executions
  3. 03Review execution output
  4. 04Inspect project nodes and system information

MCP support

Provides MCP tools for Rundeck operations through the Rundeck CLI, allowing MCP clients to interact with Rundeck without direct command-line use.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Rundeck MCP Server

This is a Model Context Protocol (MCP) server for interacting with the Rundeck CLI. It provides a set of tools that allow you to perform Rundeck operations with AI without directly interacting with the command line.

Features

  • Jobs Management: List, get information, execute, and predict
  • Executions Management: List, get information, get output, and track
  • Projects Management: List and get information
  • Nodes and System Information: List nodes and get system information

Installation

Prerequisites
  • Node.js (v14 or higher)
  • Rundeck CLI tool
Steps
  1. Clone this repository:
git clone https://github.com/vanisoul/rundeck-mcp-server
cd rundeck-mcp-server
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. Configure the MCP settings file:

Add the following configuration to your MCP settings file. The location of the settings file depends on your environment:

{
  "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": []
    }
  }
}

Make sure to replace the following values:

  • /path/to/rundeck-mcp-server/build/index.js: The absolute path to the built index.js file
  • /usr/bin/rd: The absolute path to the Rundeck CLI tool
  • http://your-rundeck-server:port/: Your Rundeck server URL
  • your-api-token: Your Rundeck API token
  1. Restart VS Code or Claude Desktop for the settings to take effect.

How to Install Rundeck CLI

Troubleshooting

If you encounter issues, check the following:

  1. Ensure the Rundeck CLI tool is available and working properly
  2. Make sure the RUNDECK_CLI_PATH environment variable points to the correct Rundeck CLI tool path
  3. Ensure the RUNDECK_BASE_URL and RUNDECK_API_TOKEN environment variables are set correctly
  4. Check that the MCP settings file is configured correctly

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.