rundeck-mcp-server

rundeck-mcp-server

0
os_automation

The Rundeck MCP Server provides a set of tools for performing Rundeck operations using AI, eliminating the need for direct CLI interaction. It supports management of jobs, executions, projects, and nodes, offering a streamlined setup with detailed configuration guidance.

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