기능 요청
해결하고 싶은 문제와, 지금은 그 문제를 어떻게 우회하고 있는지 적어 주세요. 명확한 문제는 완성된 해결책보다 이야기하기 쉬워요.
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이 명령은 이 서버 URL과 인증 시크릿을 담은 MCP 항목을 stdio 모드로 기록하고, 도구를 미리 승인해요.
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, enum, import, impl 블록, 호출 관계로 파싱해 그래프에 저장해요.
언어 17개
언어에 마우스를 올리거나, 포커스하거나, 탭하면 PO가 그 언어에서 뽑아내는 심볼의 종류를 볼 수 있어요.
해 보기: 언어에 마우스를 올리거나 탭하세요
파일마다 추출하는 것: 함수, 구조체, trait, enum, import, 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}
계획 실행 하나를 위한 스트림이에요. 실행기 이벤트(작업 시작, 웨이브 시작...)와 모든 하위 세션의 채팅 이벤트를 담아요.
브라우저는 쿠키로 인증하거나, 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은 외부 MCP 서버를 stdio, sse, streamable_http로 연결해서, 그 도구를 PO를 통해 쓸 수 있게 해요.
기여
Project Orchestrator는 오픈 소스예요. 아이디어와 버그 신고는 모두 GitHub에 이슈로 올라가고, 누구나 읽을 수 있어요.
해결하고 싶은 문제와, 지금은 그 문제를 어떻게 우회하고 있는지 적어 주세요. 명확한 문제는 완성된 해결책보다 이야기하기 쉬워요.
GitHub에 공개 이슈로 등록돼요. 관리자와 다른 사용자가 읽고 의견을 보탤 수 있어요.
무엇을 했고, 무엇을 기대했고, 실제로 무슨 일이 일어났는지 알려 주세요. 재현 단계가 정확할수록 문제를 재현하기 쉬워요.
GitHub에 공개 이슈로 등록돼요. 관리자와 다른 사용자가 읽고 의견을 보탤 수 있어요.