Rundeck MCP Server

Rundeck MCP サーバー

これは、Rundeck CLI と連携するための Model Context Protocol（MCP）サーバーです。コマンドラインを直接操作せずに、AI を使って Rundeck の操作を実行できるツールを提供します。

機能

• ジョブ管理：一覧表示、情報の取得、実行、予測
• 実行管理：一覧表示、情報の取得、出力の取得、追跡
• プロジェクト管理：一覧表示、情報の取得
• ノードとシステム情報：ノードの一覧表示、システム情報の取得

インストール

前提条件

• Node.js（v14 以降）
• Rundeck CLI ツール

手順

1. このリポジトリをクローンします。

git clone https://github.com/vanisoul/rundeck-mcp-server
cd rundeck-mcp-server

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

4. MCP 設定ファイルを設定します。

以下の設定を MCP 設定ファイルに追加します。設定ファイルの場所は環境によって異なります。

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

以下の値を置き換えてください。

• /path/to/rundeck-mcp-server/build/index.js：ビルド済みの index.js ファイルの絶対パス
• /usr/bin/rd：Rundeck CLI ツールの絶対パス
• http://your-rundeck-server:port/：Rundeck サーバーの URL
• your-api-token：Rundeck API トークン

5. 設定を反映するため、VS Code または Claude Desktop を再起動します。

Rundeck CLI のインストール方法

• https://docs.rundeck.com/docs/rd-cli/install.html

トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. Rundeck CLI ツールが利用可能で、正常に動作していることを確認します。
2. RUNDECK_CLI_PATH 環境変数が正しい Rundeck CLI ツールのパスを指していることを確認します。
3. RUNDECK_BASE_URL と RUNDECK_API_TOKEN 環境変数が正しく設定されていることを確認します。
4. MCP 設定ファイルが正しく設定されていることを確認します。

ライセンス

MIT