ModMind MCP Server

Этот каталог представляет собой публикуемый слой протокола MCP, извлеченный из ModMind. Он реализует локальный сервер stdio, использующий методы JSON-RPC MCP, и перенаправляет вызовы инструментов на уже запущенный мост ModMind через loopback HTTP.

Начальный снимок отслеживает линию настольного приложения 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 запускают процесс и общаются через JSON, разделенный переводами строк, на stdin/stdout. Не записывайте логи в stdout; stdout — это канал протокола.

Related MCP server: mcp-stdio

Конфигурация клиента

Скопируйте examples/mcp-config.json, замените оба пути и импортируйте его в клиент, поддерживающий локальные серверы MCP stdio. Настольное приложение обычно создает bridge.json и конфигурацию для каждого проекта автоматически. MODMIND_BRIDGE_CONFIG является необязательным, если bridge.json находится рядом с mcp-server.mjs.

Информацию о команде запуска хост-приложения 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.