CodeAlive MCP

CodeAlive MCP: глубокий контекст для вашего проекта (особенно для больших кодовых баз)

Этот сервер MCP (Model Context Protocol) для API CodeAlive позволяет клиентам ИИ, таким как Claude Desktop, Cursor, Windserf, VS Code (GitHub Copilot), Cline, Roo-Code и Refact, получать доступ к расширенным функциям семантического поиска кода CodeAlive и взаимодействия с кодовой базой.

CodeAlive MCP расширяет возможности этих агентов, предоставляя обогащенный контекст из кодовой базы вашего проекта, обеспечивая более интеллектуальное и эффективное взаимодействие.

Что такое CodeAlive?

CodeAlive — это платформа, которая анализирует всю вашу кодовую базу, включая документацию и зависимости, чтобы понять ее структуру, шаблоны и логику. Она создает подробную внутреннюю карту ваших репозиториев или рабочих пространств, позволяя любому ИТ-специалисту быстро, надежно и качественно отвечать на вопросы о вашем решении.

Использование этого сервера MCP позволяет агентам ИИ (таким как Claude, Copilot и т. д.) использовать глубокое понимание кода CodeAlive. Это помогает агентам:

• Находите нужный код быстрее: получайте точные фрагменты кода, соответствующие вашим вопросам.
• Понимание общей картины: получение контекста обо всем репозитории или рабочем пространстве, а не только об отдельных файлах.
• Сокращение затрат и времени: повышение эффективности работы агентов за счет предоставления точного контекста напрямую, что снижает необходимость в обширном поиске файлов или догадках.

Оглавление

• Доступные инструменты
• Начиная
  • Предпосылки
  • Получение API-ключа
  • Установка
• Конфигурация
  • Переменные среды
  • Параметры командной строки
• Интеграция с клиентами ИИ
  • Продолжать
  • Клод Десктоп
  • Visual Studio Code с GitHub Copilot
  • Курсор
• Использование Python напрямую
  • Рабочий стол Клода с Python
  • Курсор с Python
• Поиск неисправностей
• Лицензия

Доступные инструменты

Сервер MCP предоставляет следующие инструменты:

1. chat_completions : Доступ к API чата CodeAlive с контекстом кодовой базы. Если ваш ключ API назначен только одному источнику данных, указание источника данных необязательно.
2. get_data_sources : список доступных репозиториев и рабочих пространств, проиндексированных CodeAlive.
3. search_code : Поиск фрагментов кода в ваших источниках данных с помощью семантического поиска CodeAlive. Если ваш ключ API назначен только одному источнику данных, указание источника данных необязательно.

Начиная

Предпосылки

• Питон 3.11
• uv (рекомендуется) или pip
• Аккаунт CodeAlive и ключ API

Получение API-ключа

1. Войдите в свою учетную запись CodeAlive по адресу https://app.codealive.dev/ .
2. Перейдите в раздел «Ключи API» (в разделе «Организация»).
3. Нажмите « + Создать ключ API ».
4. Дайте вашему ключу описательное имя (например, «Мой локальный ключ MCP») и выберите соответствующую область действия (например, «Все источники данных» или выберите конкретные).
5. Нажмите « Создать ».
6. Важно: Скопируйте сгенерированный ключ API немедленно и сохраните его в надежном месте. Вы не сможете увидеть его снова после закрытия диалогового окна.

Установка

Установка с помощью УФ (рекомендуется)

Установка с помощью pip

Установка через Smithery

Чтобы автоматически установить CodeAlive для Claude Desktop через Smithery :

Конфигурация

Настройте сервер, используя переменные среды или аргументы командной строки.

Переменные среды

Поддерживаются следующие переменные среды:

• CODEALIVE_API_KEY : Ваш ключ API CodeAlive. (Требуется, если не передан через --api-key )

Параметры командной строки

• --api-key : Ваш ключ API CodeAlive. Переопределяет переменную среды CODEALIVE_API_KEY .
• --transport : Тип транспорта: "stdio" (по умолчанию) или "sse" .
• --host : Адрес хоста для транспорта SSE (по умолчанию: 0.0.0.0 ).
• --port : Порт для транспорта SSE (по умолчанию: 8000 ).
• --debug : включить режим отладки с подробным протоколированием в стандартный вывод/ошибки.

Интеграция с клиентами ИИ

Ниже приведены примеры конфигурации для популярных клиентов AI. Не забудьте заменить заполнители, такие как /path/to/your/codealive-mcp и YOUR_API_KEY_HERE , на ваши фактические значения. Использование переменных окружения (блок env ) обычно рекомендуется вместо размещения ключа API непосредственно в файле конфигурации.

Продолжать

1. Настройте сервер MCP в .continue/config.yaml вашего проекта или глобально в файле ~/.continue/config.yaml :
   # ~/.continue/config.yaml or ./.continue/config.yaml mcpServers: - name: CodeAlive command: /path/to/your/codealive-mcp/.venv/bin/python # Or use 'uv' if preferred (see Cursor example) args: - /path/to/your/codealive-mcp/src/codealive_mcp_server.py - --debug # Optional: Enable debug logging env: CODEALIVE_API_KEY: YOUR_API_KEY_HERE
2. Перезагрузить Продолжить или перезагрузить конфигурацию.

Клод Десктоп

1. Отредактируйте файл конфигурации Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json (обычно C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json )
2. Добавьте конфигурацию сервера MCP:
   { "mcpServers": { "codealive": { "command": "/path/to/your/codealive-mcp/.venv/bin/python", "args": [ "/path/to/your/codealive-mcp/src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } }
   (Убедитесь, что слияние прошло правильно, если файл уже имеет содержимое)
3. Полностью перезагрузите Claude Desktop.

Visual Studio Code с GitHub Copilot

1. Откройте настройки VS Code (JSON) с помощью палитры команд ( Ctrl+Shift+P или Cmd+Shift+P ) и выберите «Настройки: Открыть настройки пользователя (JSON)».
2. Добавьте конфигурацию сервера MCP в ваш settings.json :
   { // ... other settings ... "mcp": { "servers": { "codealive": { "command": "uv", "args": [ "--directory", "/path/to/your/codealive-mcp", // Path to the MCP server project root "run", "python", "src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } } // ... other settings ... }
   (Убедитесь, что это правильно объединяется с существующими настройками)
3. Перезапустите VS Code. Убедитесь, что расширение GitHub Copilot настроено на потенциальное использование серверов MCP, если это требуется его версией/настройками.

Курсор

1. Откройте настройки курсора ( Cmd+, или Ctrl+, ).
2. Перейдите в раздел «MCP» на левой панели.
3. Нажмите «Добавить новый глобальный сервер MCP».
4. Введите следующую конфигурацию JSON, обновив пути и ключ API:
   { "mcpServers": { "codealive": { "command": "uv", "args": [ "--directory", "/path/to/your/codealive-mcp", // Path to the MCP server project root "run", "python", "src/codealive_mcp_server.py", "--debug" // Optional: Enable debug logging ], "env": { "CODEALIVE_API_KEY": "YOUR_API_KEY_HERE" } } } }
5. Сохраните конфигурацию.
6. Полностью перезапустите курсор.

Использование Python напрямую

Если вы предпочитаете не использовать uv , вы можете вызвать скрипт сервера напрямую с помощью интерпретатора Python из вашей виртуальной среды. Обновите command и args в клиентских конфигурациях соответствующим образом.

Рабочий стол Клода с Python

Курсор с Python

Поиск неисправностей

Если сервер MCP не работает корректно с вашим AI-клиентом, выполните следующие действия:

1. Включить отладку журнала: добавьте флаг --debug к args в конфигурации MCP вашего клиента. Это выведет подробные журналы с самого сервера MCP в его стандартный поток вывода/ошибок. Куда идет этот поток, зависит от того, как клиент управляет процессом MCP.
2. Проверьте вывод сервера MCP:
   • Попробуйте запустить команду сервера непосредственно в терминале (сначала активируйте виртуальную среду):
     # Activate venv first! export CODEALIVE_API_KEY="YOUR_API_KEY_HERE" python src/codealive_mcp_server.py --debug --transport stdio
   • Обращайте внимание на сообщения об ошибках, особенно связанные с проверкой ключа API или проблемами подключения.
3. Проверьте логи клиента: обратитесь к документации или настройкам вашего конкретного клиента AI, чтобы найти его файлы журналов. Найдите ошибки, связанные с запуском или взаимодействием с сервером MCP "codealive".
   • Клод Рабочий стол:
     • Проверьте основные журналы приложения.
     • Найдите журналы, специфичные для MCP:
       • macOS: ~/Library/Logs/Claude/mcp.log и ~/Library/Logs/Claude/mcp-server-codealive.log
       • Windows: %LOCALAPPDATA%\Claude\Logs\mcp.log и %LOCALAPPDATA%\Claude\Logs\mcp-server-codealive.log (путь обычно C:\Users\YourUsername\AppData\Local\Claude\Logs )
   • Курсор:
     • Используйте палитру команд ( Cmd+Shift+P / Ctrl+Shift+P ) -> Developer: Toggle Developer Tools -> вкладка «Консоль» (для ошибок на уровне браузера).
     • Проверьте панель вывода: перейдите в View -> Output (или щелкните Output на нижней панели). В раскрывающемся меню справа на панели вывода найдите канал с именем CodeAlive , MCP или связанный с процессом сервера. Он часто содержит прямой stdout/stderr с сервера MCP, если включен --debug .
     • Используйте палитру команд -> Developer: Open Logs Folder . Проверьте файлы внутри, особенно относящиеся к основному процессу или хосту расширения.
     • Расположение папок журналов:
       • macOS: ~/Library/Application Support/Cursor/logs/
       • Windows: %APPDATA%\Cursor\logs\ (Обычно C:\Users\YourUsername\AppData\Roaming\Cursor\logs\ )
   • VS Code (Продолжение / Второй пилот):
     • Используйте палитру команд ( Cmd+Shift+P / Ctrl+Shift+P ) -> Developer: Toggle Developer Tools -> вкладка «Консоль» (для ошибок на уровне браузера).
     • Проверьте панель вывода: перейдите в View -> Output (или щелкните Output на нижней панели). В раскрывающемся меню справа на панели вывода найдите канал с именем CodeAlive , MCP , GitHub Copilot или Continue . Журналы сервера MCP (особенно с --debug ) могут быть направлены сюда.
     • Используйте палитру команд -> Developer: Show Logs... -> Выберите Extension Host из выпадающего списка. Найдите ошибки, связанные с попытками расширений Copilot или Continue взаимодействовать через MCP.
     • Для определенных журналов Continue: используйте палитру команд -> Continue: Focus on Continue Console View (требуется включение Continue: Enable Console в настройках). См. Continue Troubleshooting Docs .
4. Проверка конфигурации: дважды проверьте пути и значения command , args и env в файле конфигурации MCP вашего клиента. Убедитесь, что синтаксис JSON/YAML правильный.
5. Ключ API: убедитесь, что ваш CODEALIVE_API_KEY правильный.

Если проблемы сохраняются, рассмотрите возможность создания проблемы в репозитории сервера CodeAlive MCP (если таковой имеется) с соответствующими журналами и подробностями конфигурации (скрывая ваш ключ API).

Вы также можете обратиться в нашу службу поддержки по адресу support@codealive.dev для получения дополнительной помощи.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .