MC-World-MCP

Minecraftサーバーディレクトリを操作するためのオフライン専用MCPツール。

このMCPは、RCON、ソケット、オンラインプレイヤーのクエリ、サーバーの起動/停止制御を意図的に使用しません。level.dat、データパック、構造物テンプレート、ログ、Anvilリージョンファイルなどのローカルファイルのみを読み書きします。

完全な書き込みパスは、DataVersion 3465のJava Edition / Arclight 1.20.1ワールドを対象としています。その他のJava Anvilワールドは検出され、ベストエフォートで読み取り可能ですが、バージョンアダプターが完全サポートと判断しない限り、ワールドへの書き込みは拒否されます。Bedrock LevelDBワールドはサポート対象外として検出されます。

実行

このプロジェクトが E:/VC/mc-world-mcp にあり、サーバーのワークスペースが E:/VC の2階層下にある場合、ワークスペースの .vscode/mcp.json でサーバーを次のように起動します。

{
  "command": "python",
  "args": ["-m", "mc_world_mcp.server"],
  "env": {
    "PYTHONPATH": "${workspaceFolder}/../../mc-world-mcp/src",
    "MC_SERVER_ROOT": "${workspaceFolder}"
  }
}

MC_SERVER_ROOT は、server.properties と world/ を含むArclightサーバーのルートディレクトリを指す必要があります。省略された場合、サーバーはまず現在の作業ディレクトリを試行します。

ワールドの選択は server.properties の level-name に従うため、level-name=world_regen_source を使用しているサーバーは、ハードコードされた world/ ではなく、そのディレクトリを通じて操作されます。明示的に上書きするには MC_WORLD_NAME を設定してください。

Related MCP server: ellmos-filecommander-mcp

安全性

すべての書き込みツールは以下の動作を行います：

• MC_SERVER_ROOT 外のパスを拒否

• java または javaw プロセスが実行中の場合は書き込みを拒否

• 選択されたワールドがDataVersion 3465でない限り、Javaワールドへの書き込みを拒否

• 変更されたすべてのファイルを backup/mc_world_mcp/<timestamp>/ 配下にバックアップ

• 変更されたファイルを記述する manifest.json を作成

読み取りツールは、サーバーの実行中も使用可能です。

ツールグループ

• Server/files: 概要、安全なファイルの読み書き、ログ、バージョン/プラットフォーム検出

• NBT: level.dat、プレイヤーデータ、ワールドデータ、構造物NBT

• Datapacks: フォルダーおよびzipデータパックのリスト表示、検証、検索、読み取り、書き込み

• Regions: スキャン、チャンクの調査、ブロックの取得/読み取り/設定/埋め込み/置換、ブロック状態文字列

• World diagnostics: ディメンション、ワールドカバレッジ、チャンクパレット、ログの問題のグループ化

• World data: ブロックエンティティ、外部エンティティリージョン、POIリージョン、バイオームボックス、高さマップのクリア、チャンクの剪定

• Templates: .nbt 構造物テンプレートのリスト表示/読み取り/書き込み、ブロックエンティティおよびベストエフォートのエンティティを含むブロックのエクスポート/配置

• Safety: オフラインチェック、バックアップリスト、バックアップ復元