Servidor MCP de ModMind

Este directorio es la capa publicable del protocolo MCP extraída de ModMind. Implementa un servidor stdio local usando métodos JSON-RPC MCP y reenvía las llamadas a herramientas a un puente de ModMind ya en ejecución a través de HTTP de bucle de retorno.

La instantánea inicial sigue la línea de escritorio de ModMind en 1.3.4; la versión del paquete (0.1.0) es independiente y debe incrementarse cuando cambie el contrato público del puente.

El servidor deliberadamente no contiene código de Electron, credenciales de proveedor, datos de proyecto, registros, binarios empaquetados de Minecraft ni dependencias de tiempo de ejecución de terceros. No es un backend de automatización de Minecraft independiente: un puente compatible debe implementar el contrato de acciones en docs/bridge-contract.md.

Ejecutar localmente

Se requiere Node.js 18.18 o superior.

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

Los clientes MCP inician el proceso y se comunican a través de JSON delimitado por saltos de línea en stdin/stdout. No escriba registros en stdout; stdout es el canal del protocolo.

Related MCP server: mcp-stdio

Configuración del cliente

Copie examples/mcp-config.json, reemplace ambas rutas, e impórtelo en un cliente que admita servidores MCP stdio locales. La aplicación de escritorio normalmente crea bridge.json y la configuración por proyecto automáticamente. MODMIND_BRIDGE_CONFIG es opcional cuando bridge.json está junto a mcp-server.mjs.

Para el comando de inicio del host de escritorio de ModMind, la selección de proyectos, el ciclo de vida, el mapeo de acciones y los requisitos de compatibilidad, consulte docs/external-bridge-integration.zh-CN.md.

Modelo de seguridad

El puente se vincula a 127.0.0.1 y requiere un token aleatorio por sesión en el encabezado x-modmind-token. Trate bridge.json como un secreto, elimínelo cuando finalice la sesión y nunca exponga el puerto del puente fuera de la máquina local. El servidor MCP no decide si una acción de escritura/construcción está permitida; esa política pertenece a la aplicación anfitriona y su adaptador de revisión.

Estado actual

El código fuente refleja los nombres de herramientas actuales de ModMind y el mapeo de acciones. El contrato de acciones público se versiona intencionalmente por separado de la aplicación de escritorio. Antes de publicar una versión, ejecute la lista de verificación de preparación en docs/open-source-preparation.zh-CN.md.