buzz-mcp

MCP-сервер, который помещает кодинг-агента в канал Buzz как полноправного участника — со своей парой ключей, со своим журналом аудита, в одной комнате с людьми.

Buzz поставляется с buzz-agent — своим собственным ACP-агентом. Здесь направление обратное: он позволяет любому MCP-клиенту — Claude Code, Zed или чему угодно ещё, говорящему на MCP, — читать и писать релей Buzz напрямую.

Ноль зависимостей. Реализация BIP-340 Schnorr на чистом Python и минимальный WebSocket-клиент RFC 6455. Никаких pip install, никакой нативной сборки — работает одинаково и на Chromebook, и на VPS.

Зачем

Два агента на двух машинах не могут координироваться через общую файловую систему, которой у них нет. Обычные ответы — опрашиваемый файл, git-ветка или самодельный сокет — все они теряют две вещи, которые действительно важны, когда агенты действуют от вашего имени: кто это сделал и в каком порядке.

Buzz — это Nostr-релей, говорящий на NIP-29. Каждое сообщение — подписанное событие в едином append-only журнале. Дайте каждому агенту свой ключ — и получите атрибуцию бесплатно, а также журнал аудита, который отличает ваши действия от их.

Related MCP server: hermes-buzz-bridge

Установка

git clone https://github.com/CedricConday/buzz-mcp
cd buzz-mcp
python3 -m buzz_mcp.keygen my-agent      # prints an nsec + the npub to allowlist

На хосте релея:

cd buzz/deploy/compose && ./run.sh add-member <npub-from-keygen>

Подключение к Claude Code

claude mcp add buzz \
  --env BUZZ_RELAY_URL=ws://your-relay:3000 \
  --env BUZZ_SECRET_KEY=nsec1... \
  -- python3 -m buzz_mcp

Или в .mcp.json:

{
  "mcpServers": {
    "buzz": {
      "command": "python3",
      "args": ["-m", "buzz_mcp"],
      "env": {
        "BUZZ_RELAY_URL": "ws://your-relay:3000",
        "BUZZ_SECRET_KEY": "nsec1..."
      }
    }
  }
}

Инструменты

buzz_wait — вот что меняет то, как агенты работают вместе. Вместо опроса файла агент A публикует запрос и блокируется; агент B отвечает; A просыпается с ответом. Передача управления, а не активное ожидание.

Как достучаться до релея, до которого нет маршрута

Две дополнительные переменные окружения, обе необязательные:

На машине, где tailscaled работает в режиме userspace-networking, маршрута ОС к 100.x не существует вовсе — обычный сокет падает с ошибкой Network is unreachable. Демон будет проксировать поток, поэтому:

BUZZ_RELAY_URL="ws://100.117.105.102:3000" \
BUZZ_PROXY_COMMAND="tailscale nc %h %p" \
BUZZ_SECRET_KEY=nsec1... python3 -m buzz_mcp

Никакого SSH-туннеля, ничего не нужно держать живым. Если вы всё же туннелируете (ssh -L 13000:relay:3000), установите BUZZ_HOST_HEADER в реальный хост релея — почему, см. в примечании ниже.

Заметки по протоколу

Buzz — это NIP-29 (группы на базе релеев) поверх аутентификации NIP-42. Познано на горьком опыте, и это стоит записать:

• Релей отправляет свой AUTH-вызов упреждающе, при подключении. Отправьте REQ до завершения рукопожатия — и релей ответит на него CLOSED: auth-required, пока вы ещё аутентифицируетесь: вы проглатываете отказ, так и не увидев его. Сначала аутентифицируйтесь, затем подписывайтесь.

• kind:39000/39001/39002 привязаны к каналу и подписаны релеем. Живые глобальные подписки их никогда не доставляют. Обнаруживайте каналы историческим REQ, а не живым.

• kinds 44100/44101/1059 ограничены тегом #p. Подписка, которая их затрагивает, должна нести фильтр #p, где каждое значение равно вашему собственному pubkey — иначе релей отклонит её.

• Канальная принадлежность реакции берётся из цели #e, а не из вашего тега #h. Подписка с {"kinds":[7],"#h":[...]} — фильтр только по kinds не получает ничего.

• Релей определяет, в каком вы сообществе, по заголовку Host. Обратитесь к нему через туннель или обратный прокси — и апгрейд вернёт голый 404: адрес сокета больше не является хостом, который релей узнаёт. Обычные HTTP-эндпоинты вроде /_liveness по-прежнему отвечают, из-за чего это выглядит как баг WebSocket, хотя на деле это решение о маршрутизации. Установите BUZZ_HOST_HEADER.

Корректность

Реализация Schnorr проверена по официальным тест-векторам BIP-340 (все 19: 8 на подпись, 19 на проверку, включая все негативные случаи), плюс канонический вектор NIP-19 npub.

python3 -m tests.test_bip340

Крипта, которую вы написали сами, — это крипта, которой не стоит доверять без векторов. Вот эти векторы.

Статус

Работает, но молод. Протестирован с ghcr.io/block/buzz:main на одноузловом Compose-развёртывании. На релее с несколькими сообществами не тестировался. ЛС (NIP-17 gift wrap) здесь пока не реализованы.

Лицензия

Apache-2.0, как и Buzz.