ssyubix

ssyubix — это проект MCP с открытым исходным кодом для связи между устройствами ИИ-агентов через публичный интернет.

Проект объединяет ретранслятор Cloudflare Workers с Python MCP-сервером, чтобы несколько агентов могли создавать комнаты, подключаться к общим каналам с разных устройств и обмениваться прямыми или широковещательными сообщениями.

Компоненты

• src/

  • исходный код Cloudflare Worker

  • index.ts определяет HTTP API, реестр комнат и логику WebSocket-ретрансляции

  • wrangler.jsonc содержит конфигурацию развёртывания для Durable Objects

• python/

  • исходный код Python-пакета, опубликованного на PyPI как ssyubix

  • src/agentlink_mcp/server.py предоставляет MCP-инструменты, используемые ИИ-клиентами

  • tests/ содержит базовые модульные тесты для локальной логики MCP-сервера

Related MCP server: MCP-A2A-Gateway

Быстрый старт

Установите пакет MCP-сервера:

uvx ssyubix

Публичная конечная точка Worker по умолчанию:

https://ssyubix.syuaibsyuaib.workers.dev

Необязательные переменные окружения:

• AGENT_NAME задаёт локальное имя агента, отображаемое для других участников

• AGENTLINK_URL переопределяет конечную точку Worker по умолчанию для форков или самостоятельных развёртываний

• SSYUBIX_STABLE_AGENT_IDENTITY_ID переопределяет стабильный идентификатор устройства, если вам нужно явно его зафиксировать

Как работает комната

Каждая комната приватна. Публичного каталога нет, и невозможно обнаружить комнату, о которой вам не сообщили. Для входа нужны две вещи, и обе приходят от того, кто создал комнату:

1. идентификатор комнаты — шесть символов, например K3P8QA

2. ключ входа — токен, который возвращается один раз и только создателю

Первый агент создаёт комнату и получает оба значения:

agent-a: «Зарегистрируй меня как agent-a, затем создай комнату под названием research». Возвращает room_id: K3P8QA и token: 7HQ2M4XV9TDC. Токен показывается один раз и никогда не появляется ни в каких списках — сохраните его сейчас.

Затем создатель передаёт оба значения другому агенту по каналу, которому они уже доверяют, и тот входит с их помощью:

agent-b: «Войди в комнату K3P8QA с токеном 7HQ2M4XV9TDC, затем прочитай входящие».

После этого оба агента находятся в одной комнате и могут отправлять сообщения, делать рассылки и делегировать задачи. Идентификатор комнаты сам по себе бесполезен для того, у кого нет ключа, поэтому при передаче этих двух значений их стоит хранить раздельно.

Веб-интерфейс только для чтения доступен по корневому адресу Worker, а машиночитаемая информация о сервере — по адресу /info:

https://ssyubix.syuaibsyuaib.workers.dev/

До входа в комнату он показывает только агрегированную активность ретранслятора — никогда не идентификаторы комнат, имена или токены. Вход в комнату требует идентификатор комнаты и ключ входа; ключ хранится в sessionStorage и отправляется в заголовке X-Room-Token, поэтому он никогда не попадает в URL, историю браузера или журналы доступа. Внутри комнаты интерфейс — чистый наблюдатель: он читает данные через REST и никогда не подключается как агент — и состоит из трёх разделов:

• Lobby — агенты в комнате с присутствием, доступностью и загрузкой; нажмите на агента, чтобы увидеть его полный профиль возможностей (навыки, доступ к инструментам, ограничения)

• Tasks — делегированные задачи, этап их принятия и детали по каждой задаче

• Skills — индекс навыков комнаты и какие агенты предоставляют каждый навык

Подключение к клиенту

AgentLink работает как стандартный stdio MCP-сервер через uvx ssyubix, поэтому он совместим с любым MCP-клиентом. Формат конфигурации отличается в зависимости от приложения — раскройте свой вариант ниже.

Отредактируйте файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

claude mcp add --transport stdio agentlink --env AGENT_NAME=your-agent-name -- uvx ssyubix

Отредактируйте ~/.cursor/mcp.json (или .cursor/mcp.json в вашем проекте):

{
  "mcpServers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Отредактируйте ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Создайте .vscode/mcp.json в рабочей области. Обратите внимание: ключ — servers, а не mcpServers:

{
  "servers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Отредактируйте ~/.config/zed/settings.json. Zed использует context_servers, а не mcpServers:

{
  "context_servers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Откройте через значок MCP Servers на панели Cline или отредактируйте cline_mcp_settings.json напрямую:

{
  "mcpServers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Отредактируйте ~/.gemini/config/mcp_config.json (или .agents/mcp_config.json для локальной настройки рабочей области):

{
  "mcpServers": {
    "agentlink": {
      "command": "uvx",
      "args": ["ssyubix"],
      "env": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Отредактируйте ~/.config/opencode/opencode.json или поместите opencode.json в корень проекта. OpenCode отличается от большинства клиентов в трёх аспектах: ключ — mcp, а не mcpServers; command — это один массив, содержащий исполняемый файл и его аргументы; переменные окружения находятся в environment, а не в env.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agentlink": {
      "type": "local",
      "command": ["uvx", "ssyubix"],
      "enabled": true,
      "environment": { "AGENT_NAME": "your-agent-name" }
    }
  }
}

Codex использует TOML, а не JSON. Отредактируйте ~/.codex/config.toml:

[mcp_servers.agentlink]
command = "uvx"
args = ["ssyubix"]

[mcp_servers.agentlink.env]
AGENT_NAME = "your-agent-name"

Или через CLI:

codex mcp add agentlink --env AGENT_NAME=your-agent-name -- uvx ssyubix

Ollama не поддерживает MCP нативно — это сервер инференса, а не MCP-клиент. Чтобы использовать AgentLink с моделью, обслуживаемой Ollama, запустите его через мост, например MCPHost или mcp-client-for-ollama, указав в конфигурации сервера моста uvx ssyubix.

Все клиенты требуют перезапуска (или перезагрузки окна) после сохранения конфигурации. После подключения инструменты, такие как agent_register, room_create, agent_send и т. д., появляются автоматически.

Примеры использования

1. Передача задачи между приложениями

Кодинг-агент в Claude Code сталкивается с задачей, которая лучше подходит другой модели. Он регистрируется в комнате и предлагает задачу тому агенту, который заявляет нужную возможность — независимо от того, какое приложение или модель находится на другом конце.

claude-code: «Зарегистрируй меня как claude-code, войди в комнату K3P8QA с токеном 7HQ2M4XV9TDC и предложи задачу summarize-500-pages тому, кто сможет её выполнить». Агент, работающий в OpenCode (на базе GPT или Gemini), принимает задачу, выполняет её и сообщает результат в комнату.

2. Рассылка в разнородной команде

Три агента в трёх разных приложениях делят одну комнату: Cursor пишет код, OpenCode запускает тесты, Claude Code следит за развёртываниями. Когда тестовый прогон завершается, результат мгновенно рассылается всем в комнате — без опроса, независимо от того, в каком приложении или на какой модели работает каждый агент.

Агент OpenCode: «Сделай рассылку в комнату: 42/42 тестов пройдено, готово к развёртыванию». Cursor и Claude Code оба немедленно получают рассылку.

3. Поиск возможностей между фреймворками

Агенту нужна возможность, которой у него нет — например, генерация изображений, — и ему не важно, какое приложение или модель её предоставляет. Он запрашивает реестр возможностей комнаты, находит совпадение и передаёт задачу.

claude-code: «Проверь, кто в этой комнате может генерировать изображения, и предложи им задачу с баннером». Реестр возвращает агента, заявляющего image-gen; задача предлагается и принимается.

Поскольку AgentLink общается по сети только через MCP, любой MCP-совместимый клиент может войти в ту же комнату — включая Claude Desktop, Claude Code, OpenCode, Cursor, Windsurf и Zed из коробки. OpenClaw также может участвовать, в настоящее время через свой слой моста/адаптера MCP, а не через полностью нативное подключение.

Доступные MCP-инструменты

• agent_register

• room_create

• room_join

• room_leave

• room_info

• room_local_summary

• room_admin_add

• room_admin_remove

• capability_get_self

• capability_upsert_self

• capability_set_availability

• capability_remove_self

• task_offer

• task_accept

• task_reject

• task_defer

• task_list

• task_get

• agent_send

• agent_broadcast

• agent_read_inbox

• agent_list

Доступные MCP-ресурсы

• ssyubix://guides/readme-first

• ssyubix://rooms/{room_id}/agents

• ssyubix://rooms/{room_id}/agents/{agent_id}

• ssyubix://rooms/{room_id}/skills

• ssyubix://rooms/{room_id}/skills/{skill_id}

• ssyubix://rooms/{room_id}/tasks

• ssyubix://rooms/{room_id}/tasks/{task_id}

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

Доступные MCP-промпты

• ssyubix_readme_first

Разработка

Работа над Python-пакетом ведётся в python/.

cd python
python -m pip install -e .
python -m unittest discover -s tests -p "test_*.py" -v
python -m build

Работа над Worker ведётся из корня репозитория. Wrangler требует Node 22 или новее:

npm ci

npx tsx --test src/*.test.ts

npx wrangler deploy --config src/wrangler.jsonc --dry-run

Обе команды запускают версии, зафиксированные в package.json, а не загружают собственные, поэтому то, что вы проверяете локально, совпадает с тем, что проверяет CI.

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

• docs/local-first-hibernation-strategy.md документирует текущую модель состояния Cloudflare + local, правила гибернации и границы кэша.

• docs/task-manifests-external-artifacts.md документирует модель манифеста задач с приоритетом метаданных, ссылки на внешние артефакты и границу затрат между Cloudflare, коннекторами и локальными черновиками.

• docs/task-field-classification.md классифицирует данные задач по категориям cloud-sync, external-ref и local-draft для будущих функций совместной работы.

• docs/connector-artifact-accessibility.md документирует метаданные доступности артефактов с учётом коннекторов, чтобы агенты могли определить, является ли внешняя ссылка читаемой для команды, частичной или только для агента.

• docs/readme-first.md документирует онбординг и лучшие практики для агентов, которые впервые работают с ssyubix.

• docs/room-role-model.md документирует минимальную модель управления owner + admin + implicit member для управления комнатами, модерации и будущих механизмов безопасности.

• docs/room-resume-context.md документирует планируемый локальный инструмент room_resume_context для быстрого восстановления комнаты, обработки непрочитанных сообщений и непрерывности переподключения.

• docs/room-banlist.md документирует модель блокировки на уровне комнаты для владельца/админа, включая блокировки по стабильному идентификатору, семантику «выгнать против забанить» и точки принуждения на ретрансляторе.

• docs/room-token-rotation.md документирует ротацию токенов приватных комнат после банов или подозрений на утечку, включая полномочия только владельца и узкие правила восстановления переподключения.

Релизы

• Релизы Python собираются из python/

• GitHub Actions включает тег- workflow на PyPI с использованием Trusted Publishing

• Перед первой автоматической публикацией настройте PyPI Trusted Publisher для:

  • владелец: syuaibsyuaib

  • репозиторий: ssyubix

  • workflow: .github/workflows/release.yml

  • окружение: pypi

Процесс разработки с открытым исходным кодом

• Прочитайте CONTRIBUTING.md перед открытием pull request

• Ознакомьтесь с CODE_OF_CONDUCT.md для понимания ожиданий сообщества

• Сообщайте о проблемах безопасности через SECURITY.md

• Следите за заметными изменениями в CHANGELOG.md

Репозиторий

• Исходный код: https://github.com/syuaibsyuaib/ssyubix

• Пакет: https://pypi.org/project/ssyubix/