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

> Как найти MCP сервер на GitHub, клонировать и собрать его, и подключить к Kodik через mcp.json.

Источник: https://docs.kodik.ru/mcp/add-from-github

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

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

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

- **Официальный репозиторий MCP серверов**: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) — эталонные реализации для распространённых инструментов
- **Awesome MCP Servers**: [github.com/punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) — курируемый сообществом список
- **Онлайн-каталоги**: [mcpservers.org](https://mcpservers.org/), [mcp.so](https://mcp.so/), [glama.ai/mcp/servers](https://glama.ai/mcp/servers), [mcp.composio.dev](https://mcp.composio.dev/)
- **PulseMCP**: [pulsemcp.com](https://www.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 с заполнителем переменной окружения. Вставьте ваш ключ туда."
```

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

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

1. Клонируйте репозиторий куда-нибудь на вашу машину:

   ```bash
   git clone https://github.com/example/my-mcp-server ~/.kodik/mcp-servers/my-mcp-server
   ```

2. Установите зависимости и соберите (пример для Node.js):

   ```bash
   cd ~/.kodik/mcp-servers/my-mcp-server
   npm install
   npm run build
   ```

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

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

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

Полный справочник всех полей конфигурации (`timeout`, `autoApprove`, `enabledTools` и т.д.) см. в [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring).

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

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

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

- **Читайте README** перед настройкой: в нём перечислены необходимые переменные среды, поддерживаемые инструменты и дополнительные шаги настройки.
- **Закрепляйтесь на конкретном коммите или теге**, когда важна стабильность. Ветка `main` может сломаться.
- **Обновляйте серверы** — `git pull` и пересборка для получения патчей безопасности и новых инструментов.
- **Используйте переменные `${input:...}`** в `mcp.json` для секретов вместо вставки их в открытом виде. См. [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring).