AXF — MCP-сервер для Claude Code: что делает и как установить
AXF превращает команды и правила репозитория в описываемые возможности для ИИ-агентов. Он пригодится, когда агентам приходится заново искать одни и те же пути сборки и проверки.
claude mcp add --env AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> --env AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> --env AXF_WORKSPACE=<AXF_WORKSPACE> --env AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> --env AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> --transport stdio axf -- npx -y @smartergpt/axfЧто делает AXF
AXF связывает репозиторий с агентами через MCP. Он помогает обнаружить доступные возможности, прочитать их контракт и запустить нужную операцию. Возможность может описывать аргументы, режим вывода, побочные эффекты, политики и цель выполнения.
В пакете есть CLI axf и MCP-сервер axf-mcp; запуск через axf mcp использует тот же интерфейс. Базовый путь включает axf doctor, axf list --compact, axf inspect и axf run. Установка выполняется через npm, а для работы с MCP сервер запускается через npx.
AXF имеет статус alpha. В пустом каталоге без маркера axf.workspace.json возможностей не будет, поэтому корень проекта и рабочий каталог нужно задать корректно для конкретного сценария.
Какие задачи решает
- найти доступные возможности репозитория
- проверить контракт операции до запуска
- запустить команду через единый интерфейс
- свести правила сборки и проверки в один маршрут
Примеры запросов агенту
- Покажи доступные возможности текущего репозитория и объясни, какую выбрать для проверки.
- Изучи контракт операции
check, затем запусти её с нужными аргументами. - Проверь состояние AXF командой
axf doctorи выведи компактный список черезaxf list --compact.
Как установить AXF
Командой платформы
claude mcp add --env AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> --env AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> --env AXF_WORKSPACE=<AXF_WORKSPACE> --env AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> --env AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> --transport stdio axf -- npx -y @smartergpt/axfВместо <…> подставьте свои значения
Командой платформы
codex mcp add axf --env AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> --env AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> --env AXF_WORKSPACE=<AXF_WORKSPACE> --env AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> --env AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> -- npx -y @smartergpt/axfВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"axf": {
"command": "npx",
"args": [
"-y",
"@smartergpt/axf"
],
"env": {
"AXF_PROJECT_ROOT": "<AXF_PROJECT_ROOT>",
"AXF_EXECUTION_ROOT": "<AXF_EXECUTION_ROOT>",
"AXF_WORKSPACE": "<AXF_WORKSPACE>",
"AXF_REGISTRY_WORKSPACE": "<AXF_REGISTRY_WORKSPACE>",
"AXF_EXECUTION_WORKSPACE": "<AXF_EXECUTION_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"axf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@smartergpt/axf"
],
"env": {
"AXF_PROJECT_ROOT": "<AXF_PROJECT_ROOT>",
"AXF_EXECUTION_ROOT": "<AXF_EXECUTION_ROOT>",
"AXF_WORKSPACE": "<AXF_WORKSPACE>",
"AXF_REGISTRY_WORKSPACE": "<AXF_REGISTRY_WORKSPACE>",
"AXF_EXECUTION_WORKSPACE": "<AXF_EXECUTION_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AXF_PROJECT_ROOT=<AXF_PROJECT_ROOT> -e AXF_EXECUTION_ROOT=<AXF_EXECUTION_ROOT> -e AXF_WORKSPACE=<AXF_WORKSPACE> -e AXF_REGISTRY_WORKSPACE=<AXF_REGISTRY_WORKSPACE> -e AXF_EXECUTION_WORKSPACE=<AXF_EXECUTION_WORKSPACE> axf npx -y @smartergpt/axfВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о AXF
Как установить AXF в Claude Code?
Выполните claude mcp add axf -- npx -y @smartergpt/axf. После этого Claude Code сможет подключить MCP-сервер AXF.
Что делает AXF?
AXF даёт агенту единый путь для обнаружения, проверки и запуска возможностей репозитория. Контракт операции описывает аргументы, эффекты, политики и цель выполнения.
На каких платформах работает AXF?
AXF подключается к Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI.
