Skip to main content
Glama

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

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

Скопируйте 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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.
      13 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      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.
      12 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables local MCP clients to access tools from a remote FastMCP server over stdio, handling OAuth authentication and Streamable HTTP communication.
      -