HandsAI Bridge

Invok桥（Go）

用Go编写的轻量级MCP（模型上下文协议）服务器，充当任何兼容MCP的IDE客户端和 调用 Spring Boot后端。

它翻译 基于stdio的JSON-RPC （MCP标准）转换为普通 HTTP REST调用 到Invok API，然后返回。

之前的Node.js/TypeScript实现已被弃用，取而代之的是这个Go版本，因为它与受限的IDE环境（如Antigravity和Claude Desktop）具有通用兼容性，在这些环境中，运行时依赖关系如下 node, npx，或 tsx 通常不可用。

为什么去？

• 零运行时依赖关系 --编译一次，随处运行。没有Node，没有npm，没有PATH问题。
• 单个二进制 --一个可执行文件，易于分发。
• IDE无关 --在Antigravity、Claude Desktop、VS Code和任何其他MCP客户端中工作相同。
• 快速启动 --没有JVM预热，没有包加载。

先决条件

• 转到1.21+ --只需要 构建 从源头。
• 正在运行的实例 调用 （默认值： http://localhost:8080).

快速开始

选项A：使用预编译的二进制文件

A预编译 invok-mcp macOS的二进制文件（darwin/arm64）包含在这个仓库中。只需使其可执行：

chmod +x invok-mcp

选项B：从源代码构建

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

配置

默认情况下，网桥连接到 http://localhost:8080.

要更改端口或主机，请创建 config.json 文件 与二进制文件位于同一目录中:

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

如果文件不存在，则自动使用默认值。

IDE集成

反重力/克劳德桌面/任何MCP客户端

将以下内容添加到您的 mcp_config.json （反重力）或 claude_desktop_config.json （克劳德桌面）：

{
  "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)

1. IDE生成 invok-mcp 作为一个子流程。
2. 网桥从以下位置读取JSON-RPC消息 stdin 逐行。
3. 对于 tools/list，它叫 GET /mcp/tools/list 在Invok上。
4. 对于 tools/call，它叫 POST /mcp/tools/call 在Invok上。
5. 回复将写回 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

相关项目

• 调用 --此网桥连接到的Spring Boot后端。