CTX MCP
MCP-сервер в одном бинарнике: ИИ читает и правит файлы нескольких проектов и запускает ваши команды
- 341 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает, пишет и ищет файлы во всех проектах из конфигурации
- Описанные вами команды выполняются в терминале с правами вашего пользователя: тесты, миграции, деплой
Установка
- Работает в
Ручная установка
curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | shДля Linux и WSL. На Windows запускается скрипт download-latest.ps1 в PowerShell с флагом AddToPath.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает, пишет и ищет файлы во всех проектах из конфигурации
- Описанные вами команды выполняются в терминале с правами вашего пользователя: тесты, миграции, деплой
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CTX — бинарник размером около 20 МБ без зависимостей, который работает в двух режимах. Режим MCP-сервера дает агенту инструменты файловой системы: чтение и запись файлов, поиск по тексту и регулярным выражениям с контекстными строками. Агент также смотрит структуру PHP-классов и обходит каталоги с фильтрами по шаблону, дате и размеру. В конфигурации `context.yaml` вы описываете собственные инструменты, и агент вызывает их через MCP. Это любая команда терминала: тесты с покрытием, миграции, линтеры, деплой на стенд с параметром, например веткой. Там же перечисляются несколько проектов, и агент работает с микросервисами одного продукта в одном диалоге. Второй режим собирает контекст в документы в формате Markdown. Источники описываются в том же файле: каталоги по маске, изменения в Git за период, репозитории GitHub, адреса. Команды `ctx init` и `ctx generate` создают конфигурацию и документы, которые удобно приложить к чату с ChatGPT или Claude. Описание схемы лежит в JSON Schema, так что агент может сам писать и править `context.yaml`.
Для кого. Для разработчиков, которые держат несколько сервисов в разных папках и хотят дать Claude Desktop или Cursor доступ к коду и своим командам через один сервер.
Подходит, если
- Агенту нужно работать сразу с несколькими репозиториями или микросервисами одного продукта
- Тесты, миграции и деплой на стенд должен запускать агент по заранее описанным командам
- Нужно собрать для чата документ с кодом нужного каталога и diff за прошлую неделю
- Нет желания ставить Node.js или Python ради MCP-сервера: хватает одного бинарника
- Вы работаете с PHP и хотите видеть иерархию классов и зависимости
Не подходит, если
- Агенту нельзя давать запись в файлы проекта: сервер умеет и писать, и запускать команды
- Нужна упаковка репозитория в один файл с подсчетом токенов: для этого есть Repomix
- Вам нужен узкоспециализированный MCP для одного сервиса: CTX общий и работает с локальными файлами
Пример запроса к агенту
Покажи список проектов из конфигурации CTX, найди в `backend-api` места, где вызывается сервис авторизации, и запусти `run-tests`MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Установочные скрипты рассчитаны на Linux, WSL и Windows. Для Windows используется PowerShell-команда с флагом AddToPath. Автор отмечает, что сервер сделан в расчете на Claude Desktop и лучше всего работает с ним. Остальные клиенты MCP подключаются по тому же принципу.
Анализ структуры классов работает только для PHP. Команды из `context.yaml` выполняются с правами вашего пользователя, поэтому набор инструментов стоит описывать вручную и проверять.
Как отключить. Удалите блок ctx из конфигурации MCP-клиента и перезапустите клиент. Бинарник и файл `context.yaml` можно удалить вручную.
Частые вопросы
Как подключить CTX к Claude Desktop?
Установите бинарник скриптом из репозитория и выполните `ctx mcp:config`: он определит систему и пропишет сервер. Вручную добавьте в mcpServers запись с командой `ctx` и аргументом `server`.
Как указать конкретный проект?
Добавьте в аргументы флаг `-c` с путем: `ctx server -c /path/to/project`. Тогда сервер берет конфигурацию этого проекта.
Можно ли превратить свою команду в инструмент для агента?
Да. В `context.yaml` в разделе `tools` задайте идентификатор, описание и команду с аргументами. Параметры вида `{{branch}}` описываются схемой и подставляются при вызове.
Чем режим генерации отличается от режима MCP?
Генерация собирает статичные документы в формате Markdown из каталогов, изменений в Git, репозиториев GitHub и адресов командой `ctx generate`. MCP-режим дает агенту работать с файлами в реальном времени.
Нужны ли Node.js или Python?
Нет, бинарник самодостаточен и весит около 20 МБ.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер индексирует код проекта, и агент достает из индекса нужные функции вместо чтения целых файлов
MCP-сервер, который превращает большую кодовую базу в семантический граф функций для точной навигации и поиска по смыслу
MCP-сервер на вашей машине, через который ChatGPT и Claude правят код, запускают тесты и смотрят Git в локальном репозитории
Context Engine — поиск по коду и память для агента
Context Engine
Скилл учит агента сначала обращаться к индексу кода и графу символов Context Engine и только потом читать файлы напрямую
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
CLI и MCP-сервер, которые по заданным правилам собирают для модели только нужные задаче файлы проекта
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| CTX (эта запись) | нет | не нужна | 341 | |
| Repomix | нет | не нужна | 29 074 | упаковывает репозиторий в один файл с подсчетом токенов, MCP-режима с запуском команд нет |
| Code2Prompt | нет | 7 743 | CLI, который собирает код в один промпт по шаблону |
Коротко о README
Автор называет CTX набором для разработки с ИИ и строит рассказ вокруг примеров context.yaml: проекты, источники контекста и собственные инструменты. Подробности вынесены на отдельный сайт документации.