ModMind MCP 服务器

本目录是从 ModMind 中提取的可发布 MCP 协议层。它使用 JSON-RPC MCP 方法实现了一个本地 stdio 服务器，并通过回环 HTTP 将工具调用转发到已在运行的 ModMind 桥接器。

初始快照跟踪 ModMind 桌面版 1.3.4 行；包版本 (0.1.0) 是独立的，当公共桥接合约发生变化时应进行更新。

该服务器故意不包含任何 Electron 代码、提供者凭据、项目数据、日志、捆绑的 Minecraft 二进制文件或第三方运行时依赖项。它不是一个独立的 Minecraft 自动化后端：兼容的桥接器必须实现 docs/bridge-contract.md 中定义的操作合约。

本地运行

需要 Node.js 18.18 或更高版本。

npm test
$env:MODMIND_BRIDGE_CONFIG = "C:\path\to\project\.modmind\external-agents\bridge.json"
node .\src\mcp-server.mjs

MCP 客户端启动进程并通过 stdin/stdout 上的换行符分隔 JSON 进行通信。不要将日志写入 stdout；stdout 是协议通道。

Related MCP server: mcp-stdio

客户端配置

复制 examples/mcp-config.json，替换两个路径，然后将其导入到支持本地 stdio MCP 服务器的客户端中。桌面应用程序通常会创建 bridge.json 和每个项目的配置。当 bridge.json 与 mcp-server.mjs 位于同一目录时，MODMIND_BRIDGE_CONFIG 是可选的。

有关 ModMind 桌面主机启动命令、项目选择、生命周期、操作映射和兼容性要求，请参阅 docs/external-bridge-integration.zh-CN.md。

安全模型

桥接器绑定到 127.0.0.1，并要求在 x-modmind-token 标头中包含一个随机会话令牌。将 bridge.json 视为机密，在会话结束时将其删除，并且永远不要将桥接器端口暴露到本地机器之外。MCP 服务器不决定是否允许写入/构建操作；该策略属于主机应用程序及其审查适配器。

当前状态

源代码反映了当前的 ModMind 工具名称和操作映射。公共操作合约有意与桌面应用程序分开版本控制。在发布版本之前，请运行 docs/open-source-preparation.zh-CN.md 中的准备清单。