Добавление MCP серверов из GitHub

Большинство MCP серверов с открытым исходным кодом размещены на GitHub. Это руководство проведёт вас через процесс поиска сервера, его сборки локально и подключения к Kodik.

Поиск MCP сервера

Хорошие места для поиска:

Официальный репозиторий MCP серверов: github.com/modelcontextprotocol/servers — эталонные реализации для распространённых инструментов
Awesome MCP Servers: github.com/punkpeye/awesome-mcp-servers — курируемый сообществом список
Онлайн-каталоги: mcpservers.org, mcp.so, glama.ai/mcp/servers, mcp.composio.dev
PulseMCP: pulsemcp.com

Каждая запись обычно показывает, какие инструменты предоставляет сервер, какая среда выполнения нужна (Node.js, Python и т.д.) и какие учётные данные требуются.

Сборка с помощью Kodik

Вы можете попросить Kodik выполнить всю настройку. Дайте ему URL репозитория (и при желании вставьте README), и он клонирует репозиторий, установит зависимости, соберёт сервер и запишет запись в mcp.json за вас.

Пример разговора:

Пользователь: "Хочу добавить MCP сервер Brave Search.
               Вот репозиторий: @https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search"

Kodik: "Клонирую в директорию MCP. Есть package.json — запустить npm run build?"

Пользователь: "Да."

Kodik: "Сборка завершена. Этому серверу нужен BRAVE_API_KEY. Куда его добавить?"

Пользователь: "Добавь в блок env в mcp.json."

Kodik: "Готово. Добавил сервер в mcp.json с заполнителем переменной окружения. Вставьте ваш ключ туда."

Ручная настройка

Если вы предпочитаете сделать это самостоятельно:

Клонируйте репозиторий куда-нибудь на вашу машину:
Окно терминала
```
git clone https://github.com/example/my-mcp-server ~/.kodik/mcp-servers/my-mcp-server
```
Установите зависимости и соберите (пример для Node.js):
Окно терминала
```
cd ~/.kodik/mcp-servers/my-mcp-server
npm install
npm run build
```

Откройте mcp.json (MCP Серверы → Установленные → Настроить MCP Серверы) и добавьте запись сервера в раздел "servers":

{
  "servers": {
    "my-mcp-server": {
      "command": "node",
      "args": ["/полный/путь/к/my-mcp-server/dist/index.js"],
      "env": {
        "API_KEY": "your-key-here",
      },
    },
  },
}

Сохраните файл. Kodik обнаружит изменение и подключится автоматически.

Полный справочник всех полей конфигурации (timeout, autoApprove, enabledTools и т.д.) см. в Настройка MCP Серверов.

Тестирование и устранение неполадок

Проверьте статусную точку рядом с сервером во вкладке Установленные. Наведите курсор на красную точку, чтобы прочитать ошибку.
Запустите команду вручную в терминале, чтобы увидеть вывод ошибок напрямую:
Окно терминала
```
node /полный/путь/к/server.js
```
Используйте MCP Inspector (npx @modelcontextprotocol/inspector) для интерактивного тестирования вызовов инструментов сервера.
Если сервер требует переменных среды, убедитесь, что они установлены в env (а не только в вашей оболочке).

Лучшие практики

Читайте README перед настройкой: в нём перечислены необходимые переменные среды, поддерживаемые инструменты и дополнительные шаги настройки.
Закрепляйтесь на конкретном коммите или теге, когда важна стабильность. Ветка main может сломаться.
Обновляйте серверы — git pull и пересборка для получения патчей безопасности и новых инструментов.
Используйте переменные ${input:...} в mcp.json для секретов вместо вставки их в открытом виде. См. Настройка MCP Серверов.