automation-queue-mcp

Claude のような LLM が自動化ジョブキューを検査・制御できるようにする MCP（Model Context Protocol）サーバーです。自然言語でジョブの一覧表示、ステータス確認、新しい実行のトリガー、失敗ジョブの再試行、キュー全体の統計取得が行えます。

作った理由

エンタープライズ RPA（AWS Lambda 経由でトリガーされる UiPath キュー、ロボット／マシンのライフサイクル、ライセンスとインフラ管理）のプラットフォームエンジニアリングを数年にわたり率いる中で、私は常に同じ問いに立ち返っていました。人間がダッシュボードを確認して失敗したジョブを手動で再トリガーする代わりに、LLM がそのキューを直接操作できたらどうなるだろうか、と。

このプロジェクトは、そのアイデアを一般化し、特定製品に依存しない形にしたものです。あらゆる自動化キューが必要とする操作（一覧表示、検査、トリガー、再試行、統計）を公開する MCP サーバーであり、LLM クライアントが自動化ジョブを会話形式で推論・管理できるようにします。

インメモリのモックキューを使用しているため、セットアップなしですぐに安全に実行・試用できます。job_queue.py を実際のバックエンド（REST API、データベース、Orchestrator クライアント）に置き換えることで、稼働中の自動化環境を対象にできます。

Related MCP server: Hatchet MCP Server

機能

対話例（Claude 経由）

あなた: 今キューで失敗しているのは何ですか？

Claude: (list_jobs を status_filter="failed" で呼び出し) 2 件のジョブが失敗しています：BOT-VM-02 の EligibilityCheck_Workflow（すでに再試行 2 回）と BOT-VM-04 の ExceptionHandling_Workflow（再試行 1 回）。どちらかを再試行しましょうか？

あなた: EligibilityCheck の方を再試行してください。

Claude: (retry_failed_job を job_id=2 で呼び出し) 完了しました — キューに戻りました。今回は再試行 3 回目です。

はじめに

git clone https://github.com/<your-username>/automation-queue-mcp.git
cd automation-queue-mcp
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install -r requirements.txt
python server.py

Claude Desktop への接続

サーバーを Claude Desktop の設定に追加します（テンプレートは examples/claude_desktop_config.json を参照）：

{
  "mcpServers": {
    "automation-queue": {
      "command": "python",
      "args": ["/absolute/path/to/automation-queue-mcp/server.py"]
    }
  }
}

Claude Desktop を再起動すると、上記の 5 つのツールが会話内で利用できるようになります。

プロジェクト構成

automation-queue-mcp/
├── server.py              # MCP server + tool definitions
├── job_queue.py            # In-memory mock job queue (swap for a real backend)
├── requirements.txt
├── examples/
│   └── claude_desktop_config.json
└── LICENSE

拡張方法

job_queue.py 内のモック JobQueue クラスは、server.py 内の MCP サーバーロジックから意図的に分離されています。実際の自動化システムに接続するには、JobQueue の 5 つのメソッド（list_jobs、get_job、queue_stats、trigger_job、retry_job）を実際のキュー／API に対して再実装するだけで済みます。MCP ツール層は変更する必要がありません。

背景

John Samuel Jacob David Ravichandran によって構築されました — エンタープライズインテリジェント自動化、プラットフォームエンジニアリング、ヘルスケア RPA におけるテクニカルリードの経歴を持ちます。詳細は LinkedIn をご覧ください。

ライセンス

MIT — LICENSE を参照してください。