Skip to main content
Glama
deenesjakoruzh
waterpail114514

ModMind MCP Server

by waterpail114514
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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-streaming-http-proxy

客户端配置

复制 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 中的准备清单。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • affinity-mcp-proxy

    MaddozS
    A
    license
    Not graded
    quality
    C
    maintenance
    Proxies the local Affinity MCP server over stdio, enabling tools to call Affinity's tools like execute_script and search_sdk_hints via MCP.
    18 npm
    4
    MIT

  • mcp-remote

    abluva
    A
    license
    Not graded
    quality
    A
    maintenance
    Bridge that lets stdio-only MCP clients connect to remote MCP servers with OAuth and other auth support, enabling local clients to use remote, authorized MCP servers.
    43 npm
    54
    MIT

  • proxycept-mcp

    MoathOthman
    A
    license
    Not graded
    quality
    C
    maintenance
    A thin stdio-to-HTTP bridge that forwards MCP messages to the hosted Proxycept server, enabling stdio-only MCP clients to access Proxycept's tool catalog.
    9 npm
    MIT