提出功能请求
描述你想解决的问题,以及你现在是怎样绕过它的。问题讲清楚,比提出一个现成的方案更容易讨论。
它会作为公开的 issue 发布在 GitHub 上,维护者和其他用户都可以阅读并补充。
面向开发者
Project Orchestrator 把应用的全部功能以 MCP 工具、REST API 和两路 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>")连接
桌面应用或服务器必须在运行。之后,一条命令就能把 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这条命令以 stdio 模式写入 MCP 配置,包含这台服务器的 URL 和它的认证密钥,并预先批准这些工具。
orchestrator setup-claude
orchestrator setup-claude --port 8080setup-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_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 参数,并分发到某一项操作。按工具、操作或参数搜索,然后复制准确的调用。
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 和推送事件。
选中一个组件,查看它的职责以及到达它的数据流,或跟随一次工具请求穿过整个系统。
试试:悬停或选中一个组件,或逐步跟随一个请求
代码解析
每个文件都会被解析为函数、结构体、trait、枚举、导入、impl 块和调用关系,然后存入图谱。
17 种语言
悬停、聚焦或点按一种语言,查看 PO 从中提取哪些类型的符号。
试试:悬停或点按一种语言
每个文件提取:函数、结构体、trait、枚举、导入、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
每一次创建、更新、删除、关联、取消关联和状态变化,都以一个 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>"}试试:按类型筛选、暂停事件流,或选中一个事件查看它的消息
扩展
这三种方式都可以通过同样的 MCP 工具使用。
用状态和转换定义一个有限状态机,启动一次运行,再让代理通过 protocol 工具推进它。
技能是随使用而浮现的笔记和代码聚类;skill 工具可以激活它们,并在项目和实例之间导出、导入。
mcp_federation 通过 stdio、sse 或 streamable_http 连接外部 MCP 服务器,使它们的工具能通过 PO 访问。
参与贡献
Project Orchestrator 是开源项目。想法和 bug 报告都会以 issue 的形式发布在 GitHub 上,任何人都可以阅读。
描述你想解决的问题,以及你现在是怎样绕过它的。问题讲清楚,比提出一个现成的方案更容易讨论。
它会作为公开的 issue 发布在 GitHub 上,维护者和其他用户都可以阅读并补充。