機能を要望する
解決したい問題と、いま回避のためにしていることを書いてください。完成した解決策よりも、はっきりした問題のほうが話し合いやすいです。
公開の issue として GitHub に登録されます。メンテナーや他のユーザーが読み、コメントを加えられます。
開発者向け
Project Orchestrator は、アプリのすべての機能を MCP ツール、REST API、2つの WebSocket ストリームとして公開します。Rust サーバーが、コード、プラン、決定、ノートを Neo4j グラフと Meilisearch に保持します。
製品そのものをお探しですか? ホームに戻ってください。
project(action: "sync", slug: "my-app")
code(
action: "analyze_impact",
target: "src/session.rs",
project_slug: "my-app"
)
plan(action: "run", plan_id: "<uuid>")接続
デスクトップアプリまたはサーバーが動いている必要があります。そのうえで、コマンド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このコマンドは、このサーバーの URL と認証シークレットを含む MCP エントリを stdio モードで書き込み、ツールを事前承認します。
orchestrator setup-claude
orchestrator setup-claude --port 8080setup-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_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>" } } }}サーバーは POST /mcp でも MCP に応答し、REST API と同じ認証の背後にあります。セッション ID は Mcp-Session-Id ヘッダーで返され、リクエストごとにそのまま返す必要があります。
Claude Code
claude mcp add --transport http project-orchestrator http://127.0.0.1:8080/mcp \ --header "Authorization: Bearer <token>"サーバーは POST /mcp でも MCP に応答し、REST API と同じ認証の背後にあります。セッション ID は Mcp-Session-Id ヘッダーで返され、リクエストごとにそのまま返す必要があります。
HTTP
POST /mcpAuthorization: Bearer <token>Content-Type: application/json{"jsonrpc":"2.0","id":1,"method":"tools/list"}試す:stdio、Claude Code、生の HTTP リクエストを切り替え、そのブロックをコピーしてください
MCP ツール
どのツールも action パラメーターを取り、1つの操作に振り分けます。ツール、アクション、パラメーターで検索し、正確な呼び出しをコピーしてください。
33 個のツール
Plans with dependency graph, waves, critical path, and the autonomous runner.
プランニングと提供 27 アクション
呼び出しの例
plan( action: "create", title: "Migrate session store to Redis", priority: 8)plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class
試す:ツールを検索し、一覧で矢印キーを使い、例を開いて、どの呼び出しもコピーできます
<uuid> のような引数の値はプレースホルダーです。アクション名とパラメーター名は、サーバーのソースから読み取っています。
アーキテクチャ
クライアントがデータベースに直接触れることはありません。クライアントはサーバーと通信し、サーバーがコードを解析し、API を提供し、イベントをストリーミングします。
コンポーネントを選ぶと、その役割と、そこに届く流れがわかります。または、ツールのリクエストがシステムを通る様子をたどってください。
試す:コンポーネントにカーソルを合わせるか選ぶか、リクエストを1ステップずつたどってください
コード解析
各ファイルは、関数、構造体、トレイト、列挙型、インポート、impl ブロック、呼び出しエッジに解析され、グラフに保存されます。
17 言語
言語にカーソルを合わせるか、フォーカスするか、タップすると、PO がそこから抽出するシンボルの種類がわかります。
試す:言語にカーソルを合わせるか、タップしてください
ファイルごとに:関数、構造体、トレイト、列挙型、インポート、impl ブロック、確信度スコア付きの関数呼び出し。
JavaScript ファイル(.js、.jsx、.mjs、.cjs)は、TypeScript の文法で読み込みます。
API とイベント
プラン、コード、ノートなどは、HTTP 上のプレーンな JSON です。変更は WebSocket でプッシュされます。
ほとんどのルートは、認証ミドルウェアの背後にあります。認証セクションが設定されていない場合、API は公開状態です。
| GET | /health | Liveness |
| GET | /api/version | Server version |
| GET | /api/projects | List projects (POST creates) |
| POST | /api/projects/{slug}/sync | Parse a project into the graph |
| GET | /api/plans/{plan_id}/waves | Parallel waves of a plan |
| POST | /api/plans/{plan_id}/run | Start the runner on a plan |
| GET | /api/code/search | Search code |
| GET | /api/code/impact | Impact analysis |
| GET | /api/notes/search | Search notes |
| GET | /api/decisions/search | Search decisions |
| POST | /api/reason | Reasoning over the graph |
| POST | /mcp | MCP over Streamable HTTP |
/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>"}試す:種類で絞り込み、ストリームを一時停止し、イベントを選ぶとメッセージが見られます
拡張
3つとも、同じ MCP ツールから利用できます。
状態と遷移を持つ有限状態機械を定義し、実行を開始して、エージェントに protocol ツールで先へ進めさせます。
スキルは、使ううちに現れるノートとコードのまとまりです。skill ツールが、それらを有効化し、プロジェクトやインスタンスをまたいでエクスポート、インポートします。
mcp_federation は、外部の MCP サーバーを stdio、sse、streamable_http でつなぎ、それらのツールを PO 経由で使えるようにします。
貢献
Project Orchestrator はオープンソースです。アイデアもバグ報告も GitHub の issue として登録され、だれでも読めます。
解決したい問題と、いま回避のためにしていることを書いてください。完成した解決策よりも、はっきりした問題のほうが話し合いやすいです。
公開の issue として GitHub に登録されます。メンテナーや他のユーザーが読み、コメントを加えられます。
何をしたか、何を期待したか、実際には何が起きたかを書いてください。手順が正確なほど、問題を再現しやすくなります。
公開の issue として GitHub に登録されます。メンテナーや他のユーザーが読み、コメントを加えられます。