Bot With Us V2 Rpc Protocol

BotWithUs MCP服务器

MCP（模型上下文协议）服务器，通过管道服务器将Claude Code等AI助手连接到游戏。将游戏状态查询、操作和缓存查找作为MCP工具公开。

先决条件

• Python 3.10+
• 游戏运行 agentcpp 注入（创建 \\.\pipe\BotWithUs_{PID})

安装

cd mcp_server
pip install -r requirements.txt

依赖关系： mcp[cli]>=1.0.0, msgpack>=1.0.0, pywin32>=306

Claude代码配置

添加到您的Claude Code MCP配置中(.claude.json, claude_desktop_config.json，或通过 claude mcp add):

{
  "mcpServers": {
    "botwithus": {
      "command": "python",
      "args": ["C:/path/to/BotWithUs2/mcp_server/server.py"]
    }
  }
}

要在多个游戏实例运行时瞄准特定的游戏实例，请执行以下操作：

{
  "args": ["C:/path/to/BotWithUs2/mcp_server/server.py", "--pid", "12345"]
}

独立运行

# Auto-discover (fails if multiple instances running)
python server.py

# Target specific PID
python server.py --pid 12345

连接行为

服务器发现匹配的管道 \\.\pipe\BotWithUs_* 在启动时。只需一个游戏实例，它就会自动连接。对于多个实例， --pid 是必需的。管道连接在第一次工具调用时延迟建立，如果断开，则会自动重新连接。

可用工具

实体查询

实体详细信息

UI组件和界面

库存和物品

游戏状态

游戏变量

缓存和配置查找

渲染和坐标

行动（不安全）

这些工具可以修改游戏状态。它们是前缀 [UNSAFE] 在他们的描述中。

登录和会话控制（不安全）

脚本执行（不安全）

效用

线路协议

MCP服务器通过Windows命名管道使用msgpack与管道服务器通信。每条消息的框架如下：

[4 bytes: little-endian uint32 body length] [N bytes: msgpack-encoded JSON body]

看 ../claudedocs/pipe_server_api.md 以获取完整的RPC方法参考。