a2a-adapter CLI
Одна команда превращает локального агента Claude Code, Codex или Pi в сервер протокола A2A, а Python SDK делает то же для кода.
- 105 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Адаптер открывает локального агента с доступом к файлам проекта как сетевой сервер, а при привязке к 0.0.0.0 без токена его увидят все в сети.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/a2a-adapterОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Адаптер открывает локального агента с доступом к файлам проекта как сетевой сервер, а при привязке к 0.0.0.0 без токена его увидят все в сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
a2a-adapter оборачивает CLI агентов, локальных агентов, движки процессов и Python-фреймворки в сервер протокола A2A (Agent-to-Agent). Карточку агента `/.well-known/agent-card.json`, JSON-RPC, жизненный цикл задач и потоковую передачу берет на себя официальный A2A SDK, поэтому адаптеру остается лишь вызвать агента. У пакета два режима. CLI запускает уже установленного агента одной командой, например `a2a-adapter claude --port 9010`, с поддержкой Claude Code, Codex, Pi, OpenClaw и DeepSeek Harness. Python SDK принимает вашу функцию или фреймворк, среди которых LangChain, LangGraph, CrewAI, n8n и Ollama, и поднимает сервер через `serve_agent(adapter, port=9000)`. По умолчанию сервер слушает `127.0.0.1`, а для удаленных подключений нужен токен.
Для кого. Разработчикам мультиагентных систем, которые подключают Claude Code, Codex или собственных агентов друг к другу по протоколу A2A.
Подходит, если
- Локальный Claude Code нужно показать другим агентам как A2A-сервер без единой строки кода.
- Функцию на Python или граф LangGraph оборачивают в A2A через `CallableAdapter` и `serve_agent`.
- Сервер должен принимать внешние подключения, и для него настраивают `--host 0.0.0.0` с `--auth-token`.
- Для сервера задают карточку агента с названием, описанием и навыками.
Не подходит, если
- Агент нужен только внутри одной сессии: сервер A2A добавит лишнюю сеть.
- Нужна замена самим агентам: адаптер их не ставит, они должны работать отдельно.
- Python старше 3.11: пакет требует 3.11 или новее.
Пример запроса к агенту
Запусти Claude Code как A2A-сервер на порту 9010 в этом проекте и покажи адрес карточки агента.Ограничения
Нужен Python 3.11 или новее. CLI ставят как изолированный инструмент командой `uv tool install a2a-adapter` или через `pipx`, а системный `pip` на macOS и многих Linux не подходит. Адаптер не ставит агентов: Claude Code нужно установить и один раз войти заранее. Агент работает в каталоге проекта с доступом к его файлам, а привязка к `0.0.0.0` без `--auth-token` открывает его всем в сети. Флаги `--push-notifications` и `--expose-error-details` по умолчанию выключены.
Как отключить. Остановите процесс `a2a-adapter` сочетанием Ctrl+C и удалите инструмент командой `uv tool uninstall a2a-adapter` или `pipx uninstall a2a-adapter`.
Частые вопросы
Как поставить CLI?
Выполните `uv tool install a2a-adapter` или `pipx install a2a-adapter`. Обновляется командой `uv tool upgrade a2a-adapter`.
Как поставить SDK?
В виртуальном окружении проекта выполните `pip install a2a-adapter`, а для фреймворка добавьте extra, например `pip install "a2a-adapter[langchain]"`.
Как передать параметры самому агенту?
Добавьте `--` и параметры после него, например `a2a-adapter claude --port 9010 -- --model <model>`. Параметры до `--` настраивают сервер.
Как открыть сервер для удаленных клиентов?
Задайте `--host 0.0.0.0` вместе с `--auth-token` или переменной `$A2A_AUTH_TOKEN`: токен требуется на всех запросах, кроме карточки агента.
Где лежит карточка агента?
По адресу `/.well-known/agent-card.json` на порту сервера, она создается автоматически.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКонсольный клиент протокола A2A: читает карточки удаленных агентов, шлет им сообщения и следит за задачами из терминала.
MCP-шлюз подключает серверы и скиллы один раз и отдает их Claude Code, Codex и OpenCode кратким описанием вместо полных схем.
ACP-адаптер для Claude Agent SDK
claude-agent-acp
Адаптер Agent Client Protocol: запускает агента на Claude Agent SDK внутри Zed и других редакторов с поддержкой ACP
Локальная панель для управления множеством агентов на разных машинах: память, граф кода и обмен сообщениями между агентами
Alook дает локальным Claude Code, Codex, Cursor и OpenCode постоянный ник и почтовый ящик, чтобы команда писала им в общих комнатах как людям
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
Коротко о README
В пакете адаптеры для CLI агентов, фреймворков и произвольных функций, клиент A2A, исполнитель задач и CLI. Рядом лежит скилл `a2a-adapter` для разработки агентов на SDK. Документация включает архитектуру, быстрый старт и справочник API.