AdaptOrch MCP — это публичная MCP-обёртка для AdaptOrch: ядро надёжности, которое позволяет Claude Code маршрутизировать задачи, запускать оркестрированные прогоны и возвращать артефакты доказательств в чат.
Используйте его, когда задача по коду слишком велика, слишком неоднозначна или слишком дорога, чтобы доверить её одному однопроходному ответу.
Claude Code → AdaptOrch MCP → route topology → run with synthesis → retrieve artifactsAdaptOrch требует аутентификации. Получите токен в два шага:
Зарегистрируйтесь → adaptorch.com/app/signup
Создайте API-ключ → adaptorch.com/app/api-keys → сгенерируйте ключ (начинается с ado_)
Используйте этот ключ как ADAPTORCH_CONTROL_PLANE_TOKEN:
export ADAPTORCH_CONTROL_PLANE_TOKEN="ado_..."Если плоскость управления работает только в режиме BYOK, храните учётные данные провайдера в окружении локального MCP-процесса:
export ADAPTORCH_MCP_PROVIDER="openai"
export ADAPTORCH_MCP_PROVIDER_MODEL="gpt-4.1-mini"
export ADAPTORCH_MCP_PROVIDER_API_KEY="<provider-api-key>"Эти значения не являются аргументами MCP-инструментов или полями JSON-тела. Они добавляются только в заголовки отправки прогонов; ключ провайдера скрывается из ошибок и не включается в запросы статуса, артефактов и использования.
Зарегистрируйтесь на /app/signup и откройте /app/api-keys.
Сгенерируйте ключ ado_* и скопируйте сырое значение один раз.
Установите его только в локальном окружении MCP как ADAPTORCH_CONTROL_PLANE_TOKEN.
Запустите adaptorch_run или adaptorch_list_runs из Claude Code.
Обновите /app/runs в дашборде, чтобы увидеть список прогонов того же тенанта.
한국어 요약: 가입 → /app/api-keys에서 ado_* 생성 → MCP env에 설정 → Claude Code에서 실행/목록 확인 → 대시보드 /app/runs에서 같은 실행 목록 확인.
Токен | Назначение | Где получить |
| Все вызовы AdaptOrch API (прогон, статус, артефакты) | Дашборд после регистрации |
| Защита вашего локального HTTP MCP-эндпоинта | Вы задаёте его (любая безопасная строка) |
Стартовый тариф $0 включает доступ к API-ключу, 1000 вызовов в месяц и теневой режим. См. adaptorch.com для тарифов Pro/Team.
AdaptOrch MCP передаёт опциональные алгоритмические параметры установленному движку adaptorch. Обёртка не реализует эти алгоритмы. Относитесь к ним как к параметрам бенчмарков/оценок или операторским параметрам, а не как к настройкам по умолчанию для быстрого старта.
Параметр | Область | Проверенное поведение |
| Бенчмарк/оценка, бета | Исправляет источники тактов/RNG для бенчмарков и канонизирует поля времени/путей записей. Не распространяется на выходы живых провайдеров, порядок записей параллельного набора, кассеты, трассировки или агрегаты времени отчётов. |
| Манифест бенчмарка | Импортируется как |
| Онлайн-маршрутизатор |
|
| Обучение онлайн-маршрутизатора |
|
| Синтез | По умолчанию — |
| Порог маршрутизации | Автоматически включается, когда существуют как минимум два ансамблевых провайдера и режим синтеза не равен |
| Синтез | Поддерживаемые режимы: |
| Извлечение из ансамбля | Извлекатели движка: |
Related MCP server: aacworkflow-mcp
AdaptOrch MCP продолжает исследовательскую линию AdaptOrch. Прочтите статью на arXiv:
Страница аннотации: arxiv.org/abs/2602.16873
HTML-версия статьи: arxiv.org/html/2602.16873v1
pip install adaptorch-mcpЕсли ядро AdaptOrch ещё не опубликовано на PyPI, сначала установите его из GitHub:
pip install "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git"
pip install adaptorch-mcpuvx adaptorch-mcp --helpС зависимостью adaptorch из GitHub:
uvx --with "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git" adaptorch-mcp --helpБыстрый выигрыш | Инструмент | Что меняется в чате |
Меньше неоднозначности доказательств |
| Claude может просматривать ограниченное представление Correctness Wall, не раскрывая внутренности селектора и не рассматривая |
Меньше провалов длинных задач |
| Крупные цели проходят через маршрутизацию, синтез и телеметрию AdaptOrch вместо одного хрупкого прохода. |
Доказательства без переключения контекста |
| Выходные данные, трассировки и доказательство прогона возвращаются в диалог Claude Code. |
Более безопасная поддержка настройки |
| Пользователи могут вставлять отредактированную диагностику, не раскрывая токены. |
Быстрый цикл установки |
| Локальная MCP-связка проверяется с помощью |
Обе ветви используют одни и те же 30 единиц, одни и те же сиды, одну и ту же сессию (gemma-4-31b на Cerebras), поэтому парная дельта исключает дрейф от прогона к прогону:
Ветвь | Точность |
Базовый уровень (robust, без шлюза верификатора) | 86.7% |
Со шлюзом верификатора AdaptOrch | 100.0% |
Парная дельта +13.3 п.п., 95% ДИ [+3.3, +26.7] — значимо.
Область применения: внутренние воспроизводимые регрессионные данные на синтетическом наборе ledger-задач (эксперимент с доказательствами
paired_confirmatory_ledger, полные ID прогонов и команды воспроизведения поставляются с основным репозиторием). Это не официальный сторонний бенчмарк.
Запустите свою нагрузку через размещённое ядро на adaptorch.com — бесплатный стартовый тариф включает API-ключ и 1000 вызовов в месяц.
Путь | Пакет | Назначение |
|
| Python CLI-обёртка вокруг |
Обёртка намеренно делегирует поведение во время выполнения модулю adaptorch.mcp_server. Это сохраняет MCP-инструменты, ресурсы, промпты, проверки безопасности и транспорты согласованными с последним релизом ядра AdaptOrch.
git clone git@github.com:dmae97/Adaptorch-MCP.git
git clone git@github.com:dmae97/adaptorch.git # alongside Adaptorch-MCP
cd Adaptorch-MCP
uv sync --all-packages --extra dev
uv run adaptorch-mcp --helpuv.lock фиксирует движок на опубликованной git-ревизии adaptorch. Чтобы проверить обёртку на локальной копии движка (прогоны algorithm-parity и MCP BYOK), установите её поверх зафиксированной версии:
make engine-local ENGINE_PATH=../adaptorch
make checkpackages/adaptorch-mcp/tests/test_engine_algorithm_parity.py завершается ошибкой, когда открытые режимы синтеза, устаревшие псевдонимы, топологии или экстракторы выходных данных расходятся с движком.
Используйте stdio для локальных клиентов, таких как Claude Code или настольные MCP-хосты.
export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
adaptorch-mcp --transport stdio --base-url https://adaptorch.comИспользуйте HTTP для локальных шлюзов, обратных прокси или удалённых MCP-клиентов.
export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"
adaptorch-mcp \
--transport http \
--base-url https://adaptorch.com \
--http-host 127.0.0.1 \
--http-port 8765Аутентифицированная проверка работоспособности:
python - <<'PY'
import os
from urllib.request import Request, urlopen
request = Request(
"http://127.0.0.1:8765/mcp/health",
headers={"Authorization": f"Bearer {os.environ['ADAPTORCH_MCP_HTTP_AUTH_TOKEN']}"},
)
with urlopen(request) as response:
print(response.read().decode("utf-8"))
PYКоманда | Назначение | Важные параметры |
| Запускает MCP-сервер stdio или HTTP. |
|
| Выводит локальную диагностику с редактированием. |
|
| Проверяет stdio |
|
Для adaptorch-mcp публичная обёртка определяет URL плоскости управления в следующем порядке: явный --base-url, затем обрезанное/проверенное значение ADAPTORCH_CONTROL_PLANE_BASE_URL, затем хостируемый запасной вариант https://adaptorch.com. adaptorch-mcp-smoke сохраняет запасной вариант для локальной разработки http://127.0.0.1:8000, если базовый URL не настроен. Передавайте --base-url явно в конфигурациях MCP-клиентов, включённых в репозиторий, для воспроизводимого поведения.
Переменная | Назначение | Примечания |
| Токен вышестоящего сервиса AdaptOrch. | Обязателен, если не передан |
| Базовый URL, используемый, когда | Обрезается и проверяется как HTTP(S); не встраивайте учётные данные. |
| Имя провайдера BYOK. | Задаётся вместе с |
| Модель провайдера BYOK. | Задаётся вместе с |
| Секрет провайдера BYOK. | Локальный для процесса, исключается из схем/тел инструментов и запросов, не связанных с запуском; необязателен только для провайдеров без ключей. |
| Bearer-токен для клиентов HTTP/SSE MCP. | Держите отдельно от токена вышестоящей плоскости управления. |
| Разрешённый список HTTP-источников (origin) через запятую. | Используйте с браузерными или удалёнными HTTP-клиентами. |
| Максимальный принимаемый размер тела HTTP-запроса. | Держите ограниченным для публичных развёртываний. |
| Бюджет тайм-аута HTTP-запроса. | Применяется к обработке запросов HTTP-сервера. |
| Максимальное количество одновременных SSE-подписчиков. | Значения по умолчанию предоставляются |
| Тайм-аут клиента плоскости управления для использования в app-factory. | Полезно при встраивании ASGI-приложения. |
| Бета-версия воспроизводимости бенчмарков/оценок. | Только для области бенчмарков/оценок; не общая детерминированность выполнения. |
| Порог обученной модели онлайн-роутера. | По умолчанию |
| Смешение лексического/семантического в paper-режиме. | По умолчанию |
{
"mcpServers": {
"adaptorch": {
"command": "adaptorch-mcp",
"args": [
"--transport",
"stdio",
"--base-url",
"https://adaptorch.com"
],
"env": {
"ADAPTORCH_CONTROL_PLANE_TOKEN": "${ADAPTORCH_CONTROL_PLANE_TOKEN}"
}
}
}
}Дополнительные шаблоны:
examples/claude_desktop_config.json
examples/omk.mcp.json
examples/mcp-http.env.example
Примеры, включённые в репозиторий, используют плейсхолдеры или интерполяцию переменных окружения. Заполняйте реальные URL и токены только в локальных незакоммиченных конфигурационных файлах.
Выведите локальную диагностику с редактированием:
adaptorch-mcp-doctor
adaptorch-mcp-doctor --json
adaptorch-mcp-doctor --strictЗапустите stdio-смоук-тест. Токен передаётся через окружение дочернего процесса, а не через аргументы процесса. Если базовый URL не указан, смоук-тест направляется на http://127.0.0.1:8000 для локальной разработки.
export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
adaptorch-mcp-smoke --base-url https://adaptorch.comОжидаемый JSON включает "ok": true, adaptorch_plan_catalog и ожидаемое подмножество основных инструментов. JSON доктора также включает отредактированные метаданные controlPlane для определённого источника базового URL. Добавляйте повторяемые флаги --expected-tool <name> при проверке конкретного хостируемого/основного релиза.
Инструмент | Назначение |
| Отправляет полезную нагрузку задачи AdaptOrch и при необходимости ожидает завершения. |
| Читает сводку запуска и его опциональное ограниченное представление Correctness Wall по |
| Читает метаданные артефактов запуска. |
| Выводит список недавних запусков. |
| Читает трассы выполнения (только профиль |
| Запрашивает отмену запуска (запись/деструктивно; оставляйте в режиме ручного подтверждения). |
| Локально маршрутизирует DAG через топологический роутер AdaptOrch (только профиль |
| Читает метрики MCP-сервера с редактированием. |
| Читает режимы синтеза (с устаревшими псевдонимами), топологии, экстракторы выходных данных, коннекторы и возможности сервера. |
| Читает окно использования вызывающего тенанта (уровень плана, период, использовано, лимит, остаток, процент). |
| Читает каталог хостируемых планов: Starter |
Профиль remote по умолчанию открывает девять инструментов, кроме adaptorch_get_traces и adaptorch_route_topology. adaptorch_get_run публикует закрытую outputSchema и безопасный structuredContent; его опциональный correctness_wall — это рекомендательная наблюдаемость, а не доказательство корректности, решение селектора или авторизация применения.
Для доверенных локальных клиентов автоматически одобряйте только те инструменты, чьи выходные данные безопасны для этого клиента. Держите adaptorch_run и adaptorch_cancel_run в режиме ручного подтверждения. Для общих или производственных клиентов избегайте автоматического одобрения инструментов чтения запусков, артефактов и трасс, если только эти данные уже не санитизированы.
Главное изображение для GitHub: assets/readme-hero.png
Диаграмма потока GitHub: assets/mcp-flow.png
Бриф промпта для растрового изображения GPT-image-2.0: docs/brand/gpt-image-2-brief.md
Перед публикацией:
uv run ruff check packages/adaptorch-mcp
uv run mypy packages/adaptorch-mcp/src
uv run pytest packages/adaptorch-mcp/tests -q
uv run python -m build packages/adaptorch-mcp --outdir dist
uv publish --dry-run dist/*Затем следуйте docs/publishing.md для PyPI Trusted Publishing или uv publish на основе токена.
Никогда не коммитьте .env, API-ключи, bearer-токены, приватные ключи или токены MCP-клиентов. См. SECURITY.md.
Проприетарная — Copyright ClassicMate. Все права защищены. См. LICENSE.
This server cannot be deployed
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
Retrieve citation-ready technical context and coordinate evidence-backed work between AI agents.
Reliable async execution for agent tool calls: schema gating, retries, idempotency, audit trail.
