Chuyển đến nội dung

Dành cho nhà phát triển

Kết nối các agent của bạn vào cùng đồ thị với kế hoạch của bạn

Project Orchestrator mở mọi thứ ứng dụng làm được dưới dạng công cụ MCP, một REST API và hai luồng WebSocket. Một máy chủ Rust giữ mã, kế hoạch, quyết định và ghi chú trong một đồ thị Neo4j và trong Meilisearch.

công cụ MCP
33
công cụ MCP
action trong số đó
426
action trong số đó
ngôn ngữ được phân tích
17
ngôn ngữ được phân tích
luồng WebSocket
4
luồng WebSocket

Bạn đang tìm chính sản phẩm? Hãy quay lại trang chủ.

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

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

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

Kết nối

Kết nối PO với một ứng dụng khách MCP

Ứng dụng máy tính hoặc máy chủ phải đang chạy. Sau đó một lệnh đăng ký PO vào Claude Code, hoặc bạn tự thêm mục cấu hình cho bất kỳ ứng dụng khách MCP nào khác.

Cài và khởi động máy chủ

Máy chủ cần Neo4j và Meilisearch. NATS là tùy chọn. Kho mã có sẵn một docker-compose.yml cho cả ba.

orchestrator serve

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

Đăng ký PO vào Claude Code

Lệnh này ghi mục MCP ở chế độ stdio, kèm URL máy chủ này và bí mật xác thực của nó, và phê duyệt trước các công cụ.

orchestrator setup-claude

orchestrator setup-claude --port 8080

setup-claude cũng thêm mcp__project-orchestrator__* vào các công cụ được phép trong ~/.claude/settings.json, nên Claude Code không hỏi trước mỗi lệnh gọi.

Kiểm tra là nó hoạt động

Trong Claude Code, chạy /mcp: project-orchestrator phải có trong danh sách. Sau đó hãy xin danh sách các dự án: Claude gọi project(action: "list").

Claude Code

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

Mọi ứng dụng khách MCP, stdio

mcp_server là một proxy mỏng: nó nói MCP qua stdio và chuyển từng lệnh gọi đến REST API. Nó không bao giờ tự kết nối với Neo4j. Đặt PO_AUTH_TOKEN, hoặc PO_JWT_SECRET để nó tự tạo token khi khởi động.

~/.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>"      }    }  }}

Thử: chuyển giữa stdio, Claude Code và một yêu cầu HTTP thô, rồi sao chép khối lệnh

Công cụ MCP

33 công cụ, một dạng lệnh gọi

Mỗi công cụ nhận một tham số action và chuyển đến một thao tác. Tìm theo công cụ, action hoặc tham số, rồi sao chép đúng lệnh gọi.

33 công cụ

plan

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

Lập kế hoạch và bàn giao 27 action

Ví dụ lệnh gọi

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

Action

+21 nữa
Tất cả ví dụ (4)

Tham số

plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class

Thử: tìm một công cụ, dùng phím mũi tên trong danh sách, mở các ví dụ và sao chép bất kỳ lệnh gọi nào

Giá trị tham số như <uuid> là chỗ giữ chỗ. Tên action và tham số được đọc từ mã nguồn của máy chủ.

Kiến trúc

Một máy chủ Rust, ba kho lưu trữ, mọi ứng dụng khách

Các ứng dụng khách không bao giờ chạm vào cơ sở dữ liệu. Chúng nói chuyện với máy chủ, nơi phân tích mã, phục vụ API và phát luồng sự kiện.

Chọn một thành phần để xem vai trò của nó và các luồng đi tới nó, hoặc theo dõi một yêu cầu công cụ đi qua hệ thống.

Thử: di chuột hoặc chọn một thành phần, hoặc theo dõi một yêu cầu từng bước

Chúng nói chuyện với nhau thế nào

  • 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

Phân tích mã

17 ngôn ngữ, được phân tích bằng tree-sitter

Mỗi tệp được phân tích thành hàm, struct, trait, enum, import, khối impl và các cạnh gọi hàm, rồi được lưu vào đồ thị.

17 ngôn ngữ

Di chuột, lấy tiêu điểm hoặc chạm vào một ngôn ngữ để xem các loại ký hiệu mà PO trích xuất từ đó.

Thử: di chuột hoặc chạm vào một ngôn ngữ

Trên mỗi tệp: hàm, struct, trait, enum, import, khối impl, lời gọi hàm kèm điểm tin cậy.

Các tệp JavaScript (.js, .jsx, .mjs, .cjs) được đọc bằng ngữ pháp TypeScript.

API và sự kiện

REST cho trạng thái, WebSocket cho thay đổi

Kế hoạch, mã, ghi chú và phần còn lại là JSON thuần qua HTTP. Các thay đổi được đẩy qua WebSocket.

Các endpoint REST chính

Hầu hết các route nằm sau middleware xác thực. Khi chưa cấu hình mục xác thực, API ở chế độ mở.

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

Các luồng WebSocket

  • /ws/events

    Mọi thao tác tạo, cập nhật, xóa, liên kết, hủy liên kết và đổi trạng thái, dưới dạng một sự kiện JSON. Lọc bằng các tham số truy vấn entity_types, project_id và layers.

  • /ws/chat/{session_id}

    Cuộc trò chuyện với trợ lý. Gửi user_message, interrupt, permission_response, input_response, set_permission_mode và set_model (mô hình đổi ngay lập tức, hoặc ở lần tiếp tục kế tiếp nếu phiên đang rảnh); nhận các sự kiện chat, được phát lại từ last_event sau khi kết nối lại.

  • /ws/run/{run_id}

    Một luồng cho một lượt chạy kế hoạch: các sự kiện của trình chạy (tác vụ đã bắt đầu, đợt đã bắt đầu...) cùng các sự kiện chat của mọi phiên con.

Trình duyệt xác thực bằng cookie, hoặc bằng một vé dùng một lần từ POST /auth/ws-ticket được truyền qua tham số ticket.

Luồng sự kiện trực tiếp, mẫu

Hình dạng là thật (CrudEvent trên /ws/events). Chính các sự kiện thì được bịa ra cho minh họa này.

10 sự kiện đang hiển thị, 10 đã nhận

Một thông điệp /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>"}

Thử: lọc theo loại, tạm dừng luồng, chọn một sự kiện để xem thông điệp của nó

Mở rộng

Ba cách để biến PO thành của bạn

Cả ba đều có sẵn qua cùng các công cụ MCP.

  • Protocol

    Định nghĩa một máy trạng thái hữu hạn với các trạng thái và chuyển tiếp, bắt đầu một lượt chạy, và để các agent đưa nó tiến lên bằng công cụ protocol.

  • Skill

    Skill là các cụm ghi chú và mã hình thành từ việc sử dụng; công cụ skill kích hoạt, xuất và nhập chúng giữa các dự án và phiên bản.

  • MCP federation

    mcp_federation kết nối các máy chủ MCP bên ngoài qua stdio, sse hoặc streamable_http, để các công cụ của chúng dùng được thông qua PO.

Đóng góp

Có ý tưởng, hay gặp lỗi? Hãy cho chúng tôi biết.

Project Orchestrator là mã nguồn mở. Ý tưởng và báo cáo lỗi đều được mở thành issue trên GitHub, nơi ai cũng có thể đọc.

Đề xuất tính năng

Mô tả vấn đề bạn muốn giải quyết, và hiện bạn đang làm gì để xoay xở. Một vấn đề rõ ràng dễ thảo luận hơn một giải pháp đã hoàn chỉnh.

Nó được mở thành một issue công khai trên GitHub, nơi những người duy trì và người dùng khác có thể đọc và góp ý thêm.

Báo cáo lỗi

Hãy cho chúng tôi biết bạn đã làm gì, bạn mong đợi điều gì và điều gì đã xảy ra thay thế. Các bước càng chính xác thì càng dễ tái hiện lỗi.

Nó được mở thành một issue công khai trên GitHub, nơi những người duy trì và người dùng khác có thể đọc và góp ý thêm.

Một báo cáo tốt bao gồm

  • Phiên bản Project Orchestrator bạn đang chạy, ví dụ tag của một bản phát hành trên trang Releases.
  • Hệ điều hành của bạn và phiên bản của nó.
  • Các bước dẫn đến vấn đề, theo đúng thứ tự, và điều bạn mong đợi thay vì vậy.
  • Thông báo lỗi chính xác hoặc ảnh chụp màn hình, nếu có.