本文へスキップ

開発者向け

エージェントを、プランと同じグラフにつなぐ

Project Orchestrator は、アプリのすべての機能を MCP ツール、REST API、2つの WebSocket ストリームとして公開します。Rust サーバーが、コード、プラン、決定、ノートを Neo4j グラフと Meilisearch に保持します。

個の MCP ツール
33
個の MCP ツール
個のアクション(action)
426
個のアクション(action)
種類の解析対応言語
17
種類の解析対応言語
本の WebSocket ストリーム
4
本の WebSocket ストリーム

製品そのものをお探しですか? ホームに戻ってください。

project(action: "sync", slug: "my-app")

code(
  action: "analyze_impact",
  target: "src/session.rs",
  project_slug: "my-app"
)

plan(action: "run", plan_id: "<uuid>")

接続

PO を MCP クライアントにつなぐ

デスクトップアプリまたはサーバーが動いている必要があります。そのうえで、コマンド1つで PO を Claude Code に登録するか、ほかの MCP クライアントには手動でエントリを追加します。

サーバーをインストールして起動する

サーバーには Neo4j と Meilisearch が必要で、NATS は任意です。リポジトリには、この3つすべて向けの docker-compose.yml が含まれています。

orchestrator serve

# needs Neo4j and Meilisearch: docker compose up -dbrew install this-rs/tap/project-orchestratororchestrator serve --port 8080

Claude Code に PO を登録する

このコマンドは、このサーバーの URL と認証シークレットを含む MCP エントリを stdio モードで書き込み、ツールを事前承認します。

orchestrator setup-claude

orchestrator setup-claude --port 8080

setup-claude は、~/.claude/settings.json の許可ツールにも mcp__project-orchestrator__* を追加するため、Claude Code は呼び出しのたびに確認しません。

動作を確認する

Claude Code で /mcp を実行すると、project-orchestrator が一覧に表示されるはずです。続いてプロジェクトの一覧を頼むと、Claude は project(action: "list") を呼び出します。

Claude Code

# in Claude Code/mcp# then ask: "List all registered projects"# Claude calls: project(action: "list")

任意の MCP クライアント、stdio

mcp_server は薄いプロキシです。stdio で MCP を話し、各呼び出しを REST API に転送します。Neo4j には自分では接続しません。PO_AUTH_TOKEN を設定するか、PO_JWT_SECRET を設定して起動時にトークンを生成させます。

~/.claude/mcp.json

{  "mcpServers": {    "project-orchestrator": {      "command": "/path/to/mcp_server",      "env": {        "PO_SERVER_URL": "http://127.0.0.1:8080",        "PO_AUTH_TOKEN": "<jwt-session-token>"      }    }  }}

試す:stdio、Claude Code、生の HTTP リクエストを切り替え、そのブロックをコピーしてください

MCP ツール

33個のツール、1つの呼び出し形式

どのツールも action パラメーターを取り、1つの操作に振り分けます。ツール、アクション、パラメーターで検索し、正確な呼び出しをコピーしてください。

33 個のツール

plan

Plans with dependency graph, waves, critical path, and the autonomous runner.

プランニングと提供 27 アクション

呼び出しの例

plan(  action: "create",  title: "Migrate session store to Redis",  priority: 8)

アクション

+あと 21 個
すべての例(4)

パラメーター

plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class

試す:ツールを検索し、一覧で矢印キーを使い、例を開いて、どの呼び出しもコピーできます

<uuid> のような引数の値はプレースホルダーです。アクション名とパラメーター名は、サーバーのソースから読み取っています。

アーキテクチャ

1つの Rust サーバー、3つのストア、任意のクライアント

クライアントがデータベースに直接触れることはありません。クライアントはサーバーと通信し、サーバーがコードを解析し、API を提供し、イベントをストリーミングします。

コンポーネントを選ぶと、その役割と、そこに届く流れがわかります。または、ツールのリクエストがシステムを通る様子をたどってください。

試す:コンポーネントにカーソルを合わせるか選ぶか、リクエストを1ステップずつたどってください

通信の方法

  • MCP clients / mcp_serverstdio
  • MCP clients / orchestratorHTTP /mcp
  • mcp_server / orchestratorREST
  • Desktop app / orchestratorREST + WebSocket
  • WebSocket clients / orchestratorWebSocket
  • orchestrator / Neo4jbolt
  • orchestrator / MeilisearchHTTP
  • orchestrator / NATSNATS
  • orchestrator / ClaudeSDK

コード解析

17言語を tree-sitter で解析

各ファイルは、関数、構造体、トレイト、列挙型、インポート、impl ブロック、呼び出しエッジに解析され、グラフに保存されます。

17 言語

言語にカーソルを合わせるか、フォーカスするか、タップすると、PO がそこから抽出するシンボルの種類がわかります。

試す:言語にカーソルを合わせるか、タップしてください

ファイルごとに:関数、構造体、トレイト、列挙型、インポート、impl ブロック、確信度スコア付きの関数呼び出し。

JavaScript ファイル(.js、.jsx、.mjs、.cjs)は、TypeScript の文法で読み込みます。

API とイベント

状態は REST、変化は WebSocket

プラン、コード、ノートなどは、HTTP 上のプレーンな JSON です。変更は WebSocket でプッシュされます。

主な REST エンドポイント

ほとんどのルートは、認証ミドルウェアの背後にあります。認証セクションが設定されていない場合、API は公開状態です。

GET/healthLiveness
GET/api/versionServer version
GET/api/projectsList projects (POST creates)
POST/api/projects/{slug}/syncParse a project into the graph
GET/api/plans/{plan_id}/wavesParallel waves of a plan
POST/api/plans/{plan_id}/runStart the runner on a plan
GET/api/code/searchSearch code
GET/api/code/impactImpact analysis
GET/api/notes/searchSearch notes
GET/api/decisions/searchSearch decisions
POST/api/reasonReasoning over the graph
POST/mcpMCP over Streamable HTTP

WebSocket ストリーム

  • /ws/events

    作成、更新、削除、リンク、リンク解除、状態変更のすべてが、1つの JSON イベントとして流れます。entity_types、project_id、layers のクエリパラメーターで絞り込めます。

  • /ws/chat/{session_id}

    アシスタントとの会話です。user_message、interrupt、permission_response、input_response、set_permission_mode、set_model を送信できます(set_model はモデルをその場で変えます。セッションが待機中なら、次の再開時に反映されます)。再接続後は、last_event 以降のチャットイベントが再生されます。

  • /ws/run/{run_id}

    プラン実行のための1つのストリーム:ランナーのイベント(タスク開始、ウェーブ開始...)に、すべての子セッションのチャットイベントを加えたものです。

ブラウザーは、Cookie か、POST /auth/ws-ticket で取得した使い切りのチケットを ticket パラメーターで渡して認証します。

ライブのイベントストリーム(サンプル)

形式は実物です(/ws/events の CrudEvent)。イベントそのものは、この図解のために作ったものです。

10 件のイベントを表示、10 件を受信

/ws/events のメッセージ

/ws/events

{  "entity_type": "task",  "action": "status_changed",  "entity_id": "<uuid>",  "payload": { "old_status": "pending", "new_status": "in_progress" },  "timestamp": "2026-10-05T10:00:00Z",  "project_id": "<uuid>"}

試す:種類で絞り込み、ストリームを一時停止し、イベントを選ぶとメッセージが見られます

拡張

PO を自分好みにする3つの方法

3つとも、同じ MCP ツールから利用できます。

  • プロトコル

    状態と遷移を持つ有限状態機械を定義し、実行を開始して、エージェントに protocol ツールで先へ進めさせます。

  • スキル

    スキルは、使ううちに現れるノートとコードのまとまりです。skill ツールが、それらを有効化し、プロジェクトやインスタンスをまたいでエクスポート、インポートします。

  • MCP フェデレーション

    mcp_federation は、外部の MCP サーバーを stdio、sse、streamable_http でつなぎ、それらのツールを PO 経由で使えるようにします。

貢献

アイデアがある? バグを見つけた? 教えてください。

Project Orchestrator はオープンソースです。アイデアもバグ報告も GitHub の issue として登録され、だれでも読めます。

機能を要望する

解決したい問題と、いま回避のためにしていることを書いてください。完成した解決策よりも、はっきりした問題のほうが話し合いやすいです。

公開の issue として GitHub に登録されます。メンテナーや他のユーザーが読み、コメントを加えられます。

バグを報告する

何をしたか、何を期待したか、実際には何が起きたかを書いてください。手順が正確なほど、問題を再現しやすくなります。

公開の issue として GitHub に登録されます。メンテナーや他のユーザーが読み、コメントを加えられます。

よい報告に含めたいこと

  • 使用している Project Orchestrator のバージョン。たとえば、リリースページのタグです。
  • お使いの OS とそのバージョン。
  • 問題に至る手順を順番どおりに、そして期待していた結果を。
  • 正確なエラーメッセージ。あればスクリーンショットも。