ModMind MCP Server

このディレクトリは、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 とプロジェクトごとの設定を自動的に作成します。 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 の準備チェックリストを 実行してください。