agentless-mcp

agentless-mcp — это не зависящая от моделей структурная машинерия для кодинг-агентов: карта репозитория на основе tree-sitter по требованию на любом уровне детализации (дерево каталогов, скелет, срез строк), поиск символов и ссылок для локализации багов, а также детерминированный разбор патчей, проверка синтаксиса и валидация кандидатов. Он никогда не вызывает языковую модель — вызывающий агент обеспечивает все рассуждения, а этот инструмент предоставляет разбор, ранжирование, ограничение и проверку, которые в противном случае пришлось бы импровизировать. Он поставляется как CLI, который любой агент может вызвать через Bash, и как тонкий stdio MCP-сервер поверх того же ядра.

Установка

На данный момент — из git:

uv tool install git+https://github.com/dmarlow-personal/agentless-mcp
agentless-mcp warmup

Добавьте extra-зависимость mcp для stdio-сервера (uv tool install "agentless-mcp[mcp] @ git+..."). Релиз на PyPI последует; до тех пор установка выполняется через git-URL.

Related MCP server: agentmako

Статус

Фазы с 1 по 6 готовы. CLI и stdio MCP-сервер работают поверх единого набора прикладных сервисов: карта репозитория, дерево каталогов, скелет, срез, поиск символов, развёртка символов, fan-in, разрешение местоположений и представления разрешённого графа — explain (многоуровневый fan-in и fan-out одного символа), path (кратчайший разрешённый путь между двумя символами) и cycles (циклы импорта на уровне модулей). Сторона записи — разбор патчей SEARCH/REPLACE, проверка синтаксиса, применение в изолированном worktree, валидация кандидатов и голосование по кластерам эквивалентности — доступна только через CLI и никогда не раскрывается через MCP.

Разрешение ссылок детерминировано и не зависит от моделей: имя связывается со своими определениями-кандидатами через импорты самого файла и его собственные определения, и каждое ребро несёт дискретный уровень доказательности, стоящий за ним (в том же файле, разрешено через импорт, уникально, неоднозначно только по имени). Граф собирается в памяти при каждом вызове из текущего дерева — ничего о нём не сохраняется, и нет никакого watcher.

По умолчанию разбор выполняется по требованию; agentless-mcp index строит кэш SQLite для каждого репозитория в $XDG_CACHE_HOME/agentless-mcp/ (никогда внутри анализируемого репозитория), содержащий символы, импорты и ссылки для файлов, чей sha256 не изменился. Каждый ответ в своей квитанции указывает поколение кэша и то, остаётся ли он собственным для данного репозитория, а --no-cache / no_cache: true принудительно включает разбор по требованию.

Репозиторий может объявлять собственные настройки по умолчанию в необязательном файле .agentless-mcp.json в своём корне (бюджет карты, максимальное количество файлов, детализация, docstrings, дополнения к стоп-листу и test_cmd, который будет использоваться только CLI-командой validate, и только когда вызов не указал собственную команду, и только после её вывода). Файл — это содержимое репозитория: каждое значение проверяется по схеме и ограничено, ни один ключ не типизирован как путь, а неизвестные ключи — это предупреждения в конверте ответа, а не ошибки.

Начните с docs/agent-guide.md: это руководство по использованию, написанное для агента, который будет вызывать этот инструмент.

Разработка

uv sync --extra mcp
uv run agentless-mcp warmup
uv run pre-commit run --all-files
uv run pytest

uv run pre-commit run --all-files — это гейт: он является строгим надмножеством запуска ruff вручную (он добавляет ruff-format, mypy strict, codespell, import-linter и deptry).

Поддержка Windows

Linux и macOS — поддерживаемые платформы: именно на них работает набор тестов, и все гарантии ниже проверяются там. Windows — это документированный best effort: у POSIX-only-вызовов есть Windows-пути, Windows CI отсутствует, и ничего здесь не выполнялось на Windows.

Покрыто:

• Вся поверхность чтения. Карта, дерево, скелет, срез, поиск символов, fan-in и разрешение местоположений — это чистый разбор и арифметика путей, а пути проходят через pathlib, при этом результаты относительно репозитория нормализуются к прямым слешам.

• Кэш тегов, включая дисциплину единственного писателя. Блокировка индекса — это fcntl.flock на POSIX и msvcrt.locking на Windows; выбор происходит в util/filelock.py. Обе неблокирующие, поэтому второй параллельный запуск индекса отклоняется, а не ставится в очередь на любой платформе.

• Разбор патчей, проверка синтаксиса и ключ эквивалентности.

Не покрыто, и разница реальна:

• Гарантия тайм-аута слабее. На POSIX тестовая команда по истечении тайм-аута убивается вместе со всей своей группой процессов (SIGTERM, затем SIGKILL), так что всё, что она породила, умирает вместе с ней. На Windows дочерний процесс создаётся с CREATE_NEW_PROCESS_GROUP, и затем terminate()/kill() отправляется только лидеру: внучатые процессы могут пережить тайм-аут. Если ваша тестовая команда запускает сервер, рассчитывайте убрать его самостоятельно.

• Нет Windows CI. Диспетчеризация платформ покрыта юнит-тестами на Linux; сами системные вызовы Windows нигде не выполняются.

• Всё, что зависит от git worktree, ведёт себя так же, как локальный git; на файловых системах Windows оно не проверялось.

Безопасность

Позиция инструмента по отношению к анализируемому репозиторию — только чтение и ограничение по путям: поверхность MCP раскрывает только инструменты чтения, применение патчей и выполнение тестов находятся на стороне CLI и по умолчанию используют изолированный git worktree, и никакое кэш- или временное состояние не записывается внутри анализируемого репозитория.

Одно предостережение о цепочке поставок стоит заявить сразу. Грамматики берутся из tree-sitter-language-pack, который при первом использовании загружает предварительно собранную платформенную сборку. Эти сборки проверяются по SHA-256 на соответствие манифесту релиза, и несовпадение является жёстким отказом — но сам манифест (parsers.json) доверяется через HTTPS, а не криптографически подписан. Мы принимаем этот риск при точном закреплении версий релиза: tree-sitter и tree-sitter-language-pack закреплены как единое целое и обновляются только через проверенное обновление. Загрузка ограничена явным этапом прогрева, и URL манифеста, и каталог кэша можно переопределить для зеркальных или изолированных от сети (air-gapped) установок. Полный аудит см. в docs/supply-chain-audit.md.

Лицензия

MIT — см. LICENSE.

Части этого пакета производны от Agentless (MIT, Copyright (c) 2024 OpenAutoCoder): примитивы среза строк, грамматика местоположений, формат правок SEARCH/REPLACE и его парсер, а также лестница фильтрации кандидатов и ключ голосования. NOTICE называет каждый файл и воспроизводит лицензию вышестоящего проекта.