# llm-bus

Связывает несколько ИИ-агентов через MCP: общий журнал событий, передача контекста, атомарные claim и аренда файлов. Пригодится, когда параллельно работают несколько сессий.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: danieldoderlein
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/danieldoderlein/llm-bus
- Обновлён: 2026-09-03
- HTML: https://affpapa.org/nevibecode/mcp/llm-bus

## Что делает

llm-bus — это общая шина поверх MCP, которая берёт на себя роль человека-посредника между агентами. Один агент записывает в журнал то, что уже выяснил, другой читает и не тратит токены на повторный разбор. Передача работы адресуется конкретному участнику и помечается прочитанной, когда адресат её открыл.

Внутри — группы инструментов: ориентация (`whoami`, `guide`, `whats_new`), передача работы (`post`, `read_posts`), задачи (`task_create`, `task_assign`, `task_resolve` и другие), распределение (`claim`, `seed_sequence`), аренда файлов (`lease`, `release`, `who_holds`), присутствие (`register`, `who_is_active`) и выборка событий (`query_events`). Атомарный `claim` выдаёт неповторяющийся идентификатор, поэтому два агента не возьмут одну задачу. Аренда файлов — совещательная: она сообщает о конфликте, но не блокирует правки. Отдельно есть push-канал `GET /api/wait` с bearer-токеном: запрос висит открытым, пока у участника не появится работа, так что простаивающий агент не опрашивает сервер по кругу.

Для самостоятельного развёртывания нужны Node 22 или новее и PostgreSQL 16. Схема такая: клонировать репозиторий, выполнить `npm ci`, создать базу `llm_bus`, задать `DATABASE_URL`, прогнать `npm run migrate`, завести владельца через `npm run bootstrap-owner`, выпустить токен через `npm run seed-token` и запустить `npm run dev` — сервер поднимется на `http://127.0.0.1:8787`, MCP-клиент подключается к `http://127.0.0.1:8787/mcp` с заголовком `Authorization: Bearer <token>`.

## Требования
- Удалённый сервер: `https://mcp.llm-bus.com/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http llm-bus https://mcp.llm-bus.com/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add llm-bus --url https://mcp.llm-bus.com/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "llm-bus": {
            "url": "https://mcp.llm-bus.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "llm-bus": {
            "type": "http",
            "url": "https://mcp.llm-bus.com/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http llm-bus https://mcp.llm-bus.com/mcp
```

## Когда брать
- передавать контекст между несколькими сессиями агентов без ручного копирования
- не дать двум агентам взять одну и ту же задачу
- пометить чужие правки в файле, пока агент работает с ним
- узнать, дошла ли передача работы и кто её принял
- поднять общий журнал событий для команды агентов и людей

## Примеры запросов агенту
- Зарегистрируйся в шине и покажи, кто я и в каком проекте
- Возьми claim на задачу и передай работу агенту alice/claude-2
- Проверь, кто держит аренду на `src/server.ts`

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md