rundeck-mcp-server

# 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: ```bash git clone https://github.com/vanisoul/rundeck-mcp-server cd rundeck-mcp-server ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` 4. Configure the MCP settings file: Add the following configuration to your MCP settings file. The location of the settings file depends on your environment: ```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://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 5. Restart VS Code or Claude Desktop for the settings to take effect. ## How to Install Rundeck CLI - https://docs.rundeck.com/docs/rd-cli/install.html ## 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