Rundeck MCP Server

🚀 ランデック MCP サーバー

このサーバーは、Rundeck CLI とのインタラクションに使用されるモデルコンテキストプロトコル（MCP）サーバーです。AI を通じて Rundeck 操作を行える一連のツールを提供し、コマンドラインと直接やり取りする必要がありません。

🚀 クイックスタート

このサーバーは、Rundeck CLI とのインタラクションに使用されるモデルコンテキストプロトコル（MCP）サーバーです。AI を通じて Rundeck 操作を行える一連のツールを提供し、コマンドラインと直接やり取りする必要がありません。

✨ 主な機能

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

📦 インストール

前提条件

• Node.js（v14 以上）
• Rundeck コマンドラインインターフェイスツール

手順

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 デスクトップを再起動して設定を有効にします。

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