AGENTS.md Generator — MCP-сервер для Claude Code: генерация AGENTS.md
Разбирает кодовую базу через tree-sitter и собирает файл AGENTS.md — инструкцию по проекту для ИИ-агентов. Полезен, когда агент входит в незнакомый репозиторий.
claude mcp add agents-md-generator -- uvx agents-md-generatorЧто делает AGENTS.md Generator
Сервер разбирает исходники на Python, C#, TypeScript, JavaScript и Go и на их основе пишет AGENTS.md по открытому стандарту agents.md. Это README для агента, а не для человека: обзор стека, слои и направление потоков данных, соглашения об именах и импортах, переменные окружения, команды установки, сборки и тестов. Секции, для которых данных не нашлось, в файл не попадают.
Внутри три инструмента. generate_agents_md запускает разбор и возвращает клиенту инструкции по чтению; scan_codebase отдаёт те же данные без задачи писать файл — пригодится, когда нужен контекст для другой работы; read_payload_chunk выдаёт результат порциями, пока has_more не станет false. Большие объёмы по MCP не гоняются.
Повторный разбор идёт по кэшу: перепарсиваются только файлы, у которых изменился SHA-256, а из изменённых берутся лишь затронутые публичные символы. Приватные символы и внутренности тестовых файлов в кэш и результат не входят. Нужны Python 3.11+, Git и MCP-клиент — без них сервер не поднимется. Установка через uvx не требует предварительной установки пакета, но сам uv должен быть в системе.
Какие задачи решает
- сгенерировать AGENTS.md для репозитория, который агент видит впервые
- получить контекст архитектуры без создания файла
- обновить описание проекта после правок в коде
- вытащить команды сборки и тестов из package.json и Makefile
- собрать список переменных окружения из исходников и .env.example
Примеры запросов агенту
- Сгенерируй AGENTS.md для этого проекта
- Сгенерируй AGENTS.md для проекта в /path/to/project
- Просканируй кодовую базу и покажи архитектуру, файл создавать не надо
Как установить AGENTS.md Generator
Командой платформы
claude mcp add agents-md-generator -- uvx agents-md-generatoruvx запускает команду с именем пакета; если в README она другая — uvx --from agents-md-generator <команда>
Командой платформы
codex mcp add agentsmd-generator -- uvx agents-md-generatoruvx запускает команду с именем пакета; если в README она другая — uvx --from agents-md-generator <команда>
Файл настроек
{
"mcpServers": {
"agentsmd-generator": {
"command": "uvx",
"args": [
"agents-md-generator"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agents-md-generator <команда>
Файл настроек
{
"servers": {
"agentsmd-generator": {
"type": "stdio",
"command": "uvx",
"args": [
"agents-md-generator"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agents-md-generator <команда>
Командой платформы
gemini mcp add agentsmd-generator uvx agents-md-generatoruvx запускает команду с именем пакета; если в README она другая — uvx --from agents-md-generator <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о AGENTS.md Generator
Как установить AGENTS.md Generator в Claude Code?
Выполните claude mcp add agents-md-generator -- uvx agents-md-generator. По умолчанию команда регистрирует сервер только для текущего проекта; флаг -s user добавляет его для всех проектов.
Что делает AGENTS.md Generator?
Разбирает исходники через tree-sitter и пишет AGENTS.md со стеком, архитектурой, соглашениями и командами запуска. Тот же разбор можно получить без файла — инструментом scan_codebase.
Что нужно для работы сервера?
Python 3.11+, Git и MCP-совместимый клиент. При запуске через uvx нужен установленный uv.
