claude-code-bridge

claude-code-bridge

constripacityMIT
8 звёзд1 форков
Claude Code Bridge — MCP-ретранслятор для обмена сообщениями между агентами Claude Code, работающими на разных машинах. Сервер использует именованные каналы для маршрутизации сообщений по принципу publish/subscribe. Один агент отправляет сообщение в канал, другой получает его в реальном времени. Для связи не требуются облачные сервисы или общие файловые системы — достаточно локальной сети или Tailscale. Сервер решает проблему координации агентов в распределенной среде. Встроенные функции: веб-дашборд для мониторинга, аудит сообщений, аутентификация и настройка хранения. Благодаря модульной архитектуре сервер может работать как в режиме HTTP с SSE, так и в чистом stdio-режиме для интеграции с любыми MCP-клиентами.
ClaudeDevelopment
Открыть на GitHub

Установка

uvx claude-code-bridge

Характеристики

Общее

  • СтатусСообщество
  • Разработчикconstripacity
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Передача сообщений между агентами Claude Code на разных компьютерах через LAN или Tailscale
  • Именованные каналы: создавайте тематические каналы для разных задач или команд
  • Публикация и подписка: агент отправляет сообщение в канал, все подписчики получают его мгновенно
  • Веб-дашборд для просмотра истории сообщений, состояния каналов и активных подключений
  • Аутентификация по токену для защиты сервера от несанкционированного доступа
  • Аудит и логгирование всех сообщений с временными метками
  • Настройка срока хранения сообщений (retention-days) для автоматической очистки
  • Режим stdio: используйте сервер как обычный MCP-сервер через стандартный ввод/вывод
  • Готовый Docker-образ на GitHub Container Registry и поддержка Docker Compose
  • Хранение данных во встроенной SQLite — не требует установки внешних баз данных

Как подключить

Шаг 1. Установите сервер

Команда для установки через uvx:

uvx claude-code-bridge

или через pip:

pip install claude-code-bridge

Шаг 2. Запустите сервер

claude-bridge --host 0.0.0.0 --port 8765

Добавьте флаг --auth-token для защиты сервера, --audit-log для включения аудита, --retention-days 30 для автоматической очистки истории. Если вам не нужен веб-дашборд, используйте флаг --no-dashboard.

Запуск через Docker:

docker run -p 8765:8765 -v claude-bridge-data:/data -e CLAUDE_BRIDGE_AUTH_TOKEN=secret ghcr.io/constripacity/claude-bridge:latest --host 0.0.0.0 --retention-days 30 --audit-log

Шаг 3. Настройте MCP-клиент

Для Claude Desktop откройте файл конфигурации claude_desktop_config.json и добавьте сервер:

{ "mcpServers": { "claude-bridge": { "command": "claude-bridge", "args": ["--stdio"] } } }

Шаг 4. Перезапустите клиент

После перезапуска агенты смогут обмениваться сообщениями через сервер. Для подключения дополнительных машин укажите IP-адрес сервера и порт в конфигурации клиента.

Примеры запросов

  • «Отправь в канал "dev-log" сообщение "Сборка завершена, код готов к ревью"»
  • «Прочитай последние 5 сообщений из канала "general"»
  • «Создай канал "feature-X" и подпиши всех агентов на него»
  • «Покажи веб-дашборд и состояние текущих каналов»

Технические детали

  • Язык: Python (3.10+)
  • Транспорт: stdio (основной), HTTP с SSE для веб-дашборда
  • Лицензия: MIT
  • Совместимые клиенты: Claude Code, Claude Desktop, любые MCP-клиенты, поддерживающие stdio
  • Зависимости: SQLite (встроенная), aiohttp для веб-интерфейса

Поделиться