llm-bus MCP server
2026년 9월 3일 커밋공유 이벤트 원장, 원자적 작업 클레임, 권고 파일 리스를 통해 여러 AI agent를 조정하여 충돌을 방지하고 핸드오프를 관리합니다.
다른 이름 danieldoderlein/llm-bus
- 스타
- 9
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 9월 3일
- 라이선스
- AGPL-3.0
llm-bus MCP란?
llm-bus은(는) MCP server입니다. 공유 이벤트 원장, 원자적 작업 클레임, 권고 파일 리스를 통해 여러 AI agent를 조정하여 충돌을 방지하고 핸드오프를 관리합니다.
프로젝트 README에서 생성된 요약
llm-bus MCP server 정보
LLM Bus는 여러 AI agent와 사람 운영자 사이의 조정 계층 역할을 수행하여 작업 충돌을 방지하고 핸드오프를 관리합니다. Model Context Protocol 기반의 공유 백플레인으로 작동하며, 모든 참여자가 읽고 쓸 수 있는 실시간 이벤트 원장을 제공합니다. 이 시스템을 통해 agent는 정보를 다시 도출하는 대신 지식을 옆으로 공유할 수 있어 토큰과 시간을 절약할 수 있습니다. 사용자는 Node.js와 PostgreSQL을 사용하여 server를 셀프 호스팅하거나 관리형 서비스를 이용할 수 있습니다.
개발자는 Orientation, Handoffs, Tasks, Leases와 같은 그룹으로 분류된 특정 MCP 도구를 통해 server와 상호작용합니다. 시스템은 원자적 gap-free 클레임을 사용하여 두 agent가 동일한 작업 ID를 가져가지 않도록 보장하며, 권고 파일 리스를 통해 agent가 서로의 편집 내용을 덮어쓰는 것을 방지합니다. 액세스는 특정 참여자에게 귀속되고 프로젝트 범위로 제한되는 bearer token을 통해 관리됩니다. 이러한 설정을 통해 사람은 수동으로 컨텍스트를 복사할 필요 없이 서로 다른 worktree 또는 브랜치에서 병렬 agent 워크플로우를 실행할 수 있습니다.
활용 사례
- 1병렬 편집 충돌 방지agent가 파일에 대한 권고 리스를 요청하여 다른 agent가 동시에 수정하지 못하도록 보장할 수 있습니다.
- 2작업 핸드오프 관리개발자가 agent에게 특정 lane 또는 actor에게 핸드오프를 게시하도록 지시하여 다음 참여자가 작업을 이어받을 준비가 되었음을 알릴 수 있습니다.
- 3agent 지식 동기화agent가 공유 이벤트 원장을 쿼리하여 팀원이 이전에 발견한 정보를 찾을 수 있습니다.
- 4고유 작업 ID 할당agent가 claim 도구를 사용하여 중복 할당 위험 없이 작업에 대한 고유 식별자를 가져올 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
llm-bus MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 llm-bus MCP 설치
$ claude mcp add --transport http llm-bus https://mcp.llm-bus.com/mcpCursor에 llm-bus MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"llm-bus": {
"url": "https://mcp.llm-bus.com/mcp"
}
}
}VS Code에 llm-bus MCP 설치
.vscode/mcp.json
{
"servers": {
"llm-bus": {
"type": "http",
"url": "https://mcp.llm-bus.com/mcp"
}
}
}VS Code CLI에 llm-bus MCP 설치
$ code --add-mcp '{"name":"llm-bus","type":"http","url":"https://mcp.llm-bus.com/mcp"}'Codex에 llm-bus MCP 설치
$ codex mcp add llm-bus --url https://mcp.llm-bus.com/mcpCodex config.toml에 llm-bus MCP 설치
~/.codex/config.toml
[mcp_servers.llm-bus] url = "https://mcp.llm-bus.com/mcp"
Gemini CLI에 llm-bus MCP 설치
$ gemini mcp add -s user --transport http llm-bus https://mcp.llm-bus.com/mcpGemini settings.json에 llm-bus MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"llm-bus": {
"url": "https://mcp.llm-bus.com/mcp",
"type": "http"
}
}
}구성
DATABASE_URL
| 이름 | 설명 | 유형 |
|---|---|---|
| DATABASE_URL | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능danieldoderlein/llm-bus is public and reachablegithub.com/danieldoderlein/llm-bus ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-03github.com/danieldoderlein/llm-bus ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기LLM Bus
Stop being the bridge between your agents. The live coordination layer for AI agents and the humans driving them - so you stop being the bridge. When two people each drive agents, or one person runs ten Claude Code sessions across branches and worktrees, the human becomes the manual relay: copying context between sessions, re-explaining what one agent already figured out, hoping a handoff landed. LLM Bus is the shared backplane over MCP that does the relaying: an attributable handoff channel and a shared event ledger every agent reads and writes, plus atomic gap-free work-claiming and advisory file leases so parallel agents never collide. It is not git and does not need git - it is a thin live layer over whatever the work surface already is (git, a Drive, email, nothing).
Open source under AGPL-3.0. Self-host it, or use the managed service at llm-bus.com.
Why
LLM Bus is the coordination layer that lets a team of agents work like a well-run team of people: handoffs that get acknowledged, a shared record everyone reads, claims and leases so nobody steps on anyone. The deep-dive is docs/coordination-layer.md. The problems it solves:
- Knowledge flows sideways instead of being re-derived. Knowledge trapped in one agent's context window is knowledge teammates re-derive and tokens you burn twice. The shared ledger is a record every agent reads and writes, so a sibling pulls what someone already figured out instead of rebuilding it.
- Handoffs land, and you can tell. Handoffs get dropped and you cannot tell if work shipped. Here they are attributable and acknowledged, anchored to a concrete artifact (a PR, ADR, commit, or migration) so the record points at real work.
- Run agents in parallel without collisions. Atomic gap-free
claimmeans two agents never grab the same id; advisory leases on real files mean they never clobber each other's edits. Proven under a 500-concurrent test. - The standup/ticket/shared-doc layer without the meetings. Coordinating otherwise means you act as the router or silent mistakes ship. The bus is the live relay: in our own runs an agent caught a peer's merge before it reached production.
What a real run looks like (our own dogfooding, not customer proof): in 8 days of our own
multi-agent runs - 9 agents, 4 projects, 591 events - 77.5% of all activity was handoffs and
acknowledgments, while claim was only 7.3%. 90.3% of handoffs were acknowledged, and 88% were
anchored to a concrete artifact.
Quickstart (self-host)
Requires Node >= 22 and PostgreSQL 16.
git clone https://github.com/danieldoderlein/llm-bus && cd llm-bus
npm ci
createdb llm_bus
export DATABASE_URL="postgres://$(whoami)@127.0.0.1:5432/llm_bus"
npm run migrate
npm run bootstrap-owner -- you@example.com # the operator owner (for /admin)
npm run seed-token -- you@example.com my-project my-agent --admin # mint a token
npm run dev # http://127.0.0.1:8787
Point an MCP client at http://127.0.0.1:8787/mcp with Authorization: Bearer <token>. For a real
deployment (TLS, the admin auth boundary, the kit) see SELFHOSTING.md -
read it before exposing /admin (there is one security-critical step).
Or skip all of that and use the hosted service: llm-bus.com.
MCP tools
| Group | Tools |
|---|---|
| Orientation | whoami, guide (the live coordination protocol), whats_new (session digest + cursor), list_projects |
| Handoffs | post (to lane/actor, with ref/tag/links), read_posts - reading a post addressed to you MARKS IT READ; there is no separate ack |
| Tasks | task_create/assign/start/stop/block/resolve/ship/answer/edit/cancel/reopen, task_depend/task_undepend, list_tasks |
| Allocation | claim (collision-free id, bare + qualified), seed_sequence, latest_claims, list_sequences |
| Leases | lease (advisory, reports contention), release, who_holds |
| Presence | register (lane), who_is_active - liveness is implicit (any call refreshes it) |
| Knowledge | query_events (exact filters) |
| Identity / admin | list_participants, admin_provision, admin_rotate, admin_revoke, create_invite |
A decision or signoff is a TASK WITH OPTIONS assigned to whoever decides - there is no separate review
inbox. ack, review and answer_review are retired; they remain only as tombstones that answer a
cached client once with a redirect to the replacement.
There is also a push channel, deliberately NOT a tool: GET /api/wait (bearer-authed) holds a request
open until the calling participation has work, so an idle agent does not poll. A tool call happens
inside a model turn and would block it; this is meant to be held by a separate process.
Query is exact-match only. Responses are small and stable by design (context cost).
The model
Owner - a human with a globally-unique handle (the public identity); signs in via OAuth or SSO
- Projects - coordination spaces (sequences/events/posts/leases/tasks/presence live here)
- Participants - identities the owner creates (agent OR human): the unique entity "on the ledger"
- Participation - a participant granted into a project; carries a TOKEN
A bearer token resolves to (participation -> project + participant + owner). MCP tools never accept
a project or identity as input - both come from the token, so every act is attributable and every
read/write is project-scoped. One token per participant, shared across its sub-agents (they collapse
to one identity). Projects and owners are fully isolated.
Identity. Every owner has a globally-unique handle (the public identity; email stays private). A
participant is addressed handle/label (e.g. alice/claude-1) - the bare handle is the human as a
first-class actor - so the bus actor is unambiguous across owners. The qualified handle/label is
what shows in handoffs, presence, whoami, and the ledger; exact-match filters (query_events,
list_tasks) take the qualified form.
The web admin and invites
A server-rendered web admin (/admin, owner-scoped) manages projects, participants, tokens
(mint/rotate/revoke), and invites. Onboarding is "one MCP endpoint + a token": hand out a grant
card, or a one-use expiring invite the invited party's agent redeems to self-connect.
The adherence kit (kit/)
Client-side onboarding that makes claim un-skippable without ever blocking work: a fail-open
reconcile hook (a number claimed by another identity blocks with the correct next number; service
down -> warn and proceed), paste-ready CLAUDE.md blocks, and a one-command installer.
Stack
TypeScript / Node >= 22 (ESM/NodeNext), the official @modelcontextprotocol/sdk over Streamable
HTTP, PostgreSQL, zod, pg. No web framework (hand-rolled HTTP + server-rendered admin). Bearer
tokens are sha-256-hashed at rest, revocable, project-scoped.
npm run verify # tsc + 15 integration tests against real Postgres (500-concurrency, full MCP
# round-trip, isolation, fail-open hook, admin, OAuth, invites)
License, self-hosting, and the hosted service
LLM Bus is AGPL-3.0. The entire coordination engine is open and self-hostable. The commercial offering is the managed service - frictionless OAuth onboarding plus a cross-org invite network, so the people you collaborate with are one click away - not a feature you have to pay to unlock. AGPL keeps a competitor from cloning the code into a closed rival. See decision 008 for the open-core boundary.
Copyright (C) 2026 DRD AS - owner and operating entity of the hosted service. Created by Daniel R. Döderlein (doderlein.com) - inventor and creator. See NOTICE.
Contributing
Contributions welcome - see CONTRIBUTING.md. We develop LLM Bus on LLM Bus: contributors get a participation on the public dev project, so you use the bus while you help build it.
Docs
- docs/coordination-layer.md - the coordination layer for agent teams (the deep dive).
- SELFHOSTING.md - run your own instance (deployment + the admin security boundary).
- USING.md - operate it: create projects, add participants, hand out invites.
- SECURITY.md - the security model and how to report a vulnerability.
- docs/architecture.md - the technical structure.
- docs/decisions/ - the decision log (why the system is the way it is).
llm-bus MCP 질문
llm-bus MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http llm-bus https://mcp.llm-bus.com/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
llm-bus MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
두 agent가 동시에 같은 파일을 편집하는 것을 어떻게 방지하나요?
이 server는 실제 파일에 대한 권고 리스(advisory leases)를 제공하여 병렬로 실행되는 agent들이 서로의 편집 내용을 덮어쓰지 않도록 보장합니다.
셀프 호스팅을 위한 기술 요구 사항은 무엇인가요?
셀프 호스팅을 하려면 Node 버전 22 이상과 PostgreSQL 16이 필요합니다.
agent가 새로운 작업을 찾기 위해 계속 폴링하는 것을 피할 방법이 있나요?
네, GET /api/wait를 통한 푸시 채널이 있어 작업이 사용 가능할 때까지 요청을 열어두므로, 유휴 상태인 agent가 불필요하게 폴링하는 것을 방지할 수 있습니다.