AOCI-CODE MCP

Установка

Работает в

• Claude Code
• Codex
• Cursor
• OpenCode
• SourceCraft
• Koda
• Coddy

Ручная установка

git clone https://github.com/aoci-spec/aoci-code.git && cd aoci-code && mkdir -p build && make build

Что делает

AOCI-CODE — локальный MCP-сервер и CLI `aoci` на Go, которые помогают агенту вести в репозитории карту всей кодовой базы и схемы базы данных. Карту пишет сама модель: по строке на файл или таблицу, где записано, за что файл отвечает, с чем связан, на что опираются вызывающие и что нельзя сломать. Индекс лежит в обычных текстовых файлах рядом с кодом, версионируется Git и не привязан к модели или сессии. Новая сессия или другой агент читает его целиком и продолжает с того же места. Установка идет в четыре шага. `aoci init` создает корневой файл `aoci.txt`, `aoci.meta.txt` со словарем тегов и пустой `aoci.code.txt`, добавляет правила для агента и прописывает MCP-сервер в конфигурацию Claude Code, Codex или OpenCode. Для Cursor команда только выдает фрагмент конфигурации. `aoci scan` строит базовую версию по списку файлов из Git. После перезапуска агента вы просите построить индекс: он читает исходники, тесты и конфигурацию и записывает записи через инструменты сервера. Затем `aoci verify` и `aoci check` проверяют, что индекс и код совпадают. Дальше индекс поддерживается без вашего участия. Сервер замечает изменения кода и выдает записи, которые нужно обновить, а агент дописывает их, когда задача закончена. Всего у сервера девять инструментов по stdio: чтение правил, обзора, записей и поиска, обслуживание индекса и справочные отчеты. Для баз PostgreSQL и MySQL, а также openGauss 6.0.5, строится отдельный индекс таблиц по метаданным каталога. Команда `aoci ui` открывает локальную панель, где видны индекс, доля покрытого кода, расхождения и запущенные серверы.

Для кого. Для разработчиков, которые ведут большие проекты с Claude Code, Codex, Cursor или OpenCode, меняют агентов и сессии и не хотят объяснять систему заново каждый раз.

Пример запроса к агенту

Проверь, что сервер AOCI подключен, построй индекс этого проекта и дай ссылку на панель

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

• Версия 0.1.0-rc21 — кандидат в релиз. Автор рекомендует собрать из исходников или взять подписанный пакет со страницы релиза и пройти проверку из руководства по установке.
• Первый индекс строится долго: примерно час на 200 000 строк кода, зависит от модели и скорости агента. Работа идет пакетами и продолжается после прерывания, а предел определяет размер индекса, не число строк.
• Лицензия FSL-1.1-MIT, исходный код открыт, но прямое использование в конкурирующем продукте запрещено. Разрешены внутреннее использование, обучение и исследования без коммерции.
• Зеленый результат проверок значит, что структура и правила выдержаны, а не что каждое утверждение модели верно. Содержание записей остается за моделью.
• Конфигурацию агента `init` пишет с абсолютными путями этой машины: ее нельзя коммитить. Файлы индекса `aoci.txt`, `aoci.meta.txt`, `aoci.code.txt` в `.gitignore` не добавляют, иначе `scan` их пропустит.

Как отключить. Уберите запись сервера `aoci` из конфигурации агента: `.mcp.json`, `.codex/config.toml`, `opencode.json` или `.cursor/mcp.json`. Если ставили хуки, удалите их там же. Файлы индекса `aoci.txt`, `aoci.meta.txt`, `aoci.code.txt` и папку `.aoci/` удалите вручную, это обычные файлы репозитория. Фоновую панель останавливает команда `aoci ui --stop`.

Коротко о README

В репозитории лежат исходный код `cmd/aoci` и `internal` на Go, пример `examples/minimal-repository`, документация в `docs`, журнал изменений, политики безопасности и участия, файлы с оговорками по товарным знакам и патентам и собственный индекс проекта в `aoci*.txt`. Описание на английском и китайском объясняет принцип, показывает пример записи и разбирает формат записи, интеграцию с каждым агентом, панель и таблицу команд. Есть отдельные разделы о том, чем сервер отличается от карты репозитория, RAG, LSP и графа кода.