Nūmen MCP

Numen MCP

将你的Numen同伴变成外部AI可以驱动的工具。 Numen MCP 在你的游戏客户端内运行一个小的模型上下文协议服务器，因此像Claude这样的智能体可以列出你的同伴、控制其中一个，并直接调用其工具 —— Claude 成为大脑，而同伴则是它的手和眼睛。

支持多加载器（Fabric + NeoForge），适用于 Minecraft 1.21.1。

⚠️ 此模组本身不执行任何操作。 它需要Numen（同伴引擎）以及一个外部MCP客户端（例如 Claude Code / Claude Desktop）来连接它。请参阅下面的要求。

与普通 Numen 同伴的区别

普通 Numen 同伴使用其内置的 LLM 进行思考。Numen MCP 则允许一个外部大脑完全跳过该 LLM：

• Claude 就是玩家。 它通过感知工具（get_self_status、scan_blocks 等）读取世界，并自行决定每一个行动。
• 此模式无需 Numen API 密钥 —— Claude 负责推理；同伴仅执行工具。
• 并行编队。 每次调用都针对一个同伴，因此一个智能体可以同时驱动多个同伴。
• 生存模式合法。 暴露的工具与内置大脑使用的完全相同 —— 挖掘、移动、放置、合成。不会凭空创造任何物品。

要求

• Numen 0.0.4+ —— 同伴引擎（包含此模组所驱动的 numen-api 运行时）。
• 客户端侧。 同伴及其工具存在于所有者的游戏客户端中，因此请安装在那里。
• 一个 MCP 客户端 —— Claude Code（原生 HTTP）或 Claude Desktop（通过 mcp-remote）。

设置

1. 在你的客户端中安装Numen + Numen MCP。启动一次；它会写入 config/numen/mcp_server.json，并在监听时打印 MCP server up on http://127.0.0.1:8765/mcp。
2. 将你的 MCP 客户端指向它：
   • Claude Code —— 项目中的 .mcp.json：

     { "mcpServers": { "numen": { "type": "http", "url": "" rel="noopener nofollow" target="_blank">http://127.0.0.1:8765/mcp" } } }
     

   • Claude Desktop —— claude_desktop_config.json（需要 Node/npx）：

     { "mcpServers": { "numen": { "command": "npx", "args": ["mcp-remote", "http://127.0.0.1:8765/mcp"] } } }
     

3. 在游戏中召唤一个同伴，然后在你的智能体中：list_companions → acquire_companion → 驱动它。服务器仅在游戏运行时监听。

工具

工具	功能
list_companions	列出你当前的同伴（名称 + ID）
acquire_companion	取得控制权 —— 暂停内置大脑，释放身体
release_companion	将同伴交还给其内置大脑
（引擎工具）	每个 Numen 身体/感知工具（get_self_status、scan_blocks、auto_mine、move_to、place_block 等），每个都接受一个 companion 参数

连接时，服务器会向智能体提供一份简短说明（MCP 的 instructions）—— 什么是 Numen 以及 acquire → perceive → act → release 循环 —— 因此任何 MCP 客户端都可以开箱即用。

多人游戏

可在远程服务器上使用。Numen MCP 仅限客户端，并通过 Numen 现有的客户端→服务器协议进行驱动 —— 与内置大脑使用的数据包相同。服务器需要安装 Numen（因为同伴的存在已经需要它）；但不需要安装 Numen MCP。服务器会对每个动作进行所有者检查，因此你只能驱动你拥有的同伴。

网络与隐私

Numen MCP 会打开一个仅限本地的回环 HTTP 端点（默认为 127.0.0.1:8765）供你的 MCP 客户端连接。不会暴露到互联网，也没有数据离开你的机器。它可以在 config/numen/mcp_server.json 中完全配置：

• enabled —— 总开关。
• host / port —— 绑定地址（默认为回环地址）。
• token —— 可选的承载令牌，每次请求都需要。
• call_timeout_seconds —— 工具调用在超时前等待的时间。
• hidden_tools —— 不对外部智能体暴露的引擎工具。

链接

• 源代码与文档： https://github.com/Dwinovo/numen-mcp
• Numen（模组本身）： https://github.com/Dwinovo/minecraft-numen

采用 MIT 许可证。