Runbook MCP Server

Runbook MCP サーバー

Runbook MCP サーバーを使うと、Claude Desktop から独自のランブックを実行できます。

• 運用ランブックを実行します（例：サービスをデプロイする、Kubernetes クラスターをアップグレードする）
• 手動テスト計画を実行します（例：新しい EC2 インスタンスを作成し、そのインスタンスに ssh で接続して統合テストを実行する）

仕組みを理解するために、以下のデモ動画をご覧ください。

使用方法

ステップ 1. Claude Desktop で MCP サーバーを起動します。

config.yaml を作成します。

以下の設定を claude_desktop_config.json に記述します。

{
  "mcpServers": {
    "runbook": {
      "command": "uv",
      "args": [
        "--directory",
        "<ABSOLUTE_PATH>/runbook-mcp-server",
        "run",
        "runbook_server.py"
      ]
    }
  }
}

ステップ 2. ランブックを作成します

ランブックには Markdown ファイルまたはテキストファイルを使用できます。例を参照してください。

env/var の置換に対応しています。

env.yaml を定義します。

env:
  key: value

• {env[key]} は value に置き換えられます。
• {var.name} は変数の値に置き換えられます。

ファイルを更新したら、インデックスを再構築してください。

create_runbook ツールを使って、新しいランブックを作成することもできます。プロンプトの例を示します。

例 1

Create a new runbook:

- name: list_pods
- content: List pods in all namespaces, find pods that are not ready, and send that to Slack.

You don't need to interpret the content. Please just pass it to the tool.

ステップ 3. ランブックを実行します

ランブックを実行するには、次の手順に従います。

1. Claude Desktop で「MCP から添付」をクリックします。
2. 連携機能の一覧から get_runbook_as_prompt を選択します。
3. 実行するランブックの名前を指定します。また、カンマ区切りのリストで変数も指定します（例：var1=key1,var2=key2）。
4. 生成されたプロンプトを送信します。

すると Claude Desktop は、ほかの MCP サーバーと通信してランブックを実行します。

ランブックの実行に使用できる MCP サーバーの例

• GitHub
• Slack
• DesktopCommanderMCP
• Web 検索とブラウザーの自動化（リンク）
• Kubernetes。複数の実装があります（例：mcp-k8s-go）

開発計画

• ランブックの内容をデータベースに保存するのではなく、ファイルとして保存します。これにより、編集が簡単になります。また、GitHub を使って簡単にバージョン管理することもできます。
• 指定された入力値でインスタンス化するランブックテンプレート X
  • これは必要ないかもしれません。ユーザーはランブックの実行時に追加のプロンプトを指定するだけで済みます。
• 実行ログを保存します（監査と改善のため）
  • シークレットを削除します
  • 実行の改善に役立つ場合は、過去のログもランブックのプロンプトに渡します
• 承認フロー
  • request_approval ツールを追加します。
  • Slack チャンネルにメッセージを送信します。
  • Runbook MCP サーバーがチャンネルを監視します。誰かが（yes / no）と返信すると、処理を続行するか、エラーを返します。
• ランブック検索の改善
  • 名前の完全一致では十分ではありません
• Smithery への登録

実現可能性が明確でない、作業の候補

注：Claude Desktop は「Sampling」をサポートしていません。これにより、いくつかの制約があります。

• サブランブックと再利用可能な実行ブロック
• ランブック管理用の REST エンドポイントとフロントエンド
• ランブックを編集できるようにする（バージョン管理付き）
• ランブック X の実行計画を表示する（ドライラン）
  • MCP サーバーとツールを制限する
• 過去の会話をランブックに変換する
• ファインチューニング
• ランブックを改善できるようにする。実行が成功した場合、その結果を例として保存し、Claude に渡します。
• 定期実行
• MCP サーバーを実行するための環境（VM、docker）をプロビジョニングできるようにする