跳到正文

面向开发者

让你的代理接入与计划相同的图谱

Project Orchestrator 把应用的全部功能以 MCP 工具、REST API 和两路 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 客户端

桌面应用或服务器必须在运行。之后,一条命令就能把 PO 注册到 Claude Code;其他任何 MCP 客户端,则需要手动添加配置。

安装并启动服务器

服务器需要 Neo4j 和 Meilisearch,NATS 是可选的。仓库里提供了涵盖这三者的 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

这条命令以 stdio 模式写入 MCP 配置,包含这台服务器的 URL 和它的认证密钥,并预先批准这些工具。

orchestrator setup-claude

orchestrator setup-claude --port 8080

setup-claude 还会把 mcp__project-orchestrator__* 加入 ~/.claude/settings.json 的允许工具,因此 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 个工具,同一种调用形式

每个工具都接收一个 action 参数,并分发到某一项操作。按工具、操作或参数搜索,然后复制准确的调用。

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> 这样的参数值只是占位符。操作名和参数名读取自服务器源码。

架构

一个 Rust 服务器,三个存储,任意客户端

客户端从不直接访问数据库,而是与服务器通信。服务器负责解析代码、提供 API 和推送事件。

选中一个组件,查看它的职责以及到达它的数据流,或跟随一次工具请求穿过整个系统。

试试:悬停或选中一个组件,或逐步跟随一个请求

它们如何通信

  • 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 解析

每个文件都会被解析为函数、结构体、trait、枚举、导入、impl 块和调用关系,然后存入图谱。

17 种语言

悬停、聚焦或点按一种语言,查看 PO 从中提取哪些类型的符号。

试试:悬停或点按一种语言

每个文件提取:函数、结构体、trait、枚举、导入、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

    每一次创建、更新、删除、关联、取消关联和状态变化,都以一个 JSON 事件推送。可用 entity_types、project_id 和 layers 查询参数进行筛选。

  • /ws/chat/{session_id}

    与助手对话。发送 user_message、interrupt、permission_response、input_response、set_permission_mode 和 set_model(模型会实时切换;如果会话处于空闲状态,则在下次恢复时切换);接收聊天事件,断线重连后从 last_event 开始补发。

  • /ws/run/{run_id}

    一次计划运行的单一数据流:执行器事件(任务开始、批次开始……),加上每个子会话的聊天事件。

浏览器通过 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 属于你的三种方式

这三种方式都可以通过同样的 MCP 工具使用。

  • 流程

    用状态和转换定义一个有限状态机,启动一次运行,再让代理通过 protocol 工具推进它。

  • 技能

    技能是随使用而浮现的笔记和代码聚类;skill 工具可以激活它们,并在项目和实例之间导出、导入。

  • MCP 联合

    mcp_federation 通过 stdio、sse 或 streamable_http 连接外部 MCP 服务器,使它们的工具能通过 PO 访问。

参与贡献

有想法,或者遇到了 bug?告诉我们。

Project Orchestrator 是开源项目。想法和 bug 报告都会以 issue 的形式发布在 GitHub 上,任何人都可以阅读。

提出功能请求

描述你想解决的问题,以及你现在是怎样绕过它的。问题讲清楚,比提出一个现成的方案更容易讨论。

它会作为公开的 issue 发布在 GitHub 上,维护者和其他用户都可以阅读并补充。

报告 bug

告诉我们你做了什么、预期会怎样、实际发生了什么。步骤越具体,就越容易复现问题。

它会作为公开的 issue 发布在 GitHub 上,维护者和其他用户都可以阅读并补充。

一份好的报告应包括

  • 你运行的 Project Orchestrator 版本,例如 Releases 页面上某个发布的标签。
  • 你的操作系统及其版本。
  • 导致问题的步骤(按顺序),以及你原本预期的结果。
  • 准确的错误信息,如果有的话,也可以附上截图。