Invok Bridge (Go)

Легковесный MCP-сервер (Model Context Protocol), написанный на Go, который выступает в качестве моста между любым MCP-совместимым IDE-клиентом и бэкендом Invok на Spring Boot.

Он преобразует JSON-RPC через stdio (стандарт MCP) в обычные HTTP REST-запросы к API Invok и обратно.

Предыдущая реализация на Node.js/TypeScript была признана устаревшей в пользу этой версии на Go из-за её универсальной совместимости с ограниченными средами IDE (такими как Antigravity и Claude Desktop), где зависимости среды выполнения, такие как node, npx или tsx, часто недоступны.

Почему Go?

Отсутствие зависимостей среды выполнения — скомпилируйте один раз, запускайте где угодно. Никаких Node, npm или проблем с PATH.
Один бинарный файл — один исполняемый файл, который легко распространять.
Независимость от IDE — работает одинаково в Antigravity, Claude Desktop, VS Code и любом другом MCP-клиенте.
Быстрый запуск — нет прогрева JVM, нет загрузки пакетов.

Предварительные требования

Go 1.21+ — требуется только для сборки из исходного кода.
Запущенный экземпляр Invok (по умолчанию: http://localhost:8080).

Быстрый старт

Вариант А: Использование предварительно скомпилированного бинарного файла

Предварительно скомпилированный бинарный файл invok-mcp для macOS (darwin/arm64) включен в этот репозиторий. Просто сделайте его исполняемым:

chmod +x invok-mcp

Вариант Б: Сборка из исходного кода

git clone https://github.com/Vrivaans/handsai-bridge.git
cd handsai-bridge
go build -o invok-mcp main.go

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

По умолчанию мост подключается к http://localhost:8080.

Чтобы изменить порт или хост, создайте файл config.json в той же директории, что и бинарный файл:

{
  "handsaiUrl": "http://localhost:9090"
}

Если файл отсутствует, автоматически используются значения по умолчанию.

Интеграция с IDE

Antigravity / Claude Desktop / Любой MCP-клиент

Добавьте следующее в ваш mcp_config.json (Antigravity) или claude_desktop_config.json (Claude Desktop):

{
  "mcpServers": {
    "invok": {
      "command": "/absolute/path/to/invok-mcp",
      "args": ["mcp"]
    }
  }
}

Важно: Используйте абсолютный путь к бинарному файлу. Поле args: ["mcp"] требуется некоторыми IDE-клиентами для корректной регистрации сервера.

Как это работает

IDE (MCP Client)  →  stdio JSON-RPC  →  invok-mcp (Go)  →  HTTP  →  Invok (Spring Boot)

IDE запускает invok-mcp как подпроцесс.
Мост считывает сообщения JSON-RPC из stdin построчно.
Для tools/list он вызывает GET /mcp/tools/list в Invok.
Для tools/call он вызывает POST /mcp/tools/call в Invok.
Ответы записываются обратно в stdout в формате JSON-RPC.

Кросс-компиляция

Сборка для других платформ из macOS:

# Linux (amd64)
GOOS=linux GOARCH=amd64 go build -o invok-mcp-linux main.go

# Windows
GOOS=windows GOARCH=amd64 go build -o invok-mcp.exe main.go

# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o invok-mcp-intel main.go

Связанные проекты

Invok — бэкенд на Spring Boot, к которому подключается этот мост.

HandsAI Bridge