# AXF

AXF превращает команды и правила репозитория в описываемые возможности для ИИ-агентов. Он пригодится, когда агентам приходится заново искать одни и те же пути сборки и проверки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: SmarterGPT
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/SmarterGPT/axf
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/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` возможностей не будет, поэтому корень проекта и рабочий каталог нужно задать корректно для конкретного сценария.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `AXF_PROJECT_ROOT`, `AXF_EXECUTION_ROOT`, `AXF_WORKSPACE`, `AXF_REGISTRY_WORKSPACE`, `AXF_EXECUTION_WORKSPACE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- найти доступные возможности репозитория
- проверить контракт операции до запуска
- запустить команду через единый интерфейс
- свести правила сборки и проверки в один маршрут

## Примеры запросов агенту
- Покажи доступные возможности текущего репозитория и объясни, какую выбрать для проверки.
- Изучи контракт операции `check`, затем запусти её с нужными аргументами.
- Проверь состояние AXF командой `axf doctor` и выведи компактный список через `axf list --compact`.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [Front-End Checklist](https://affpapa.org/nevibecode/mcp/front-end-checklist.md) — MCP-сервер · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md