Minecraft Ops MCP

Minecraftサーバーの管理および運用を目的としたMCP stdioサービスです。現在のバージョンは公式のMCP Python SDKに基づいて実装されており、以下のバックエンドに対応しています：

MCSManager API：インスタンスのライフサイクル、ログ、ファイル管理、コンソールコマンド。
RCON：従来のコンソールコマンドによるフォールバック。
Minecraft Server Management Protocol（MSMP）：Minecraft Java 1.21.9+ 用の JSON-RPC over WebSocket 管理プロトコル。

ドキュメント

ユーザーマニュアル：docs/USER_MANUAL.md
開発者フレームワークガイド：docs/DEVELOPER_GUIDE.md
現在の制限事項と今後のロードマップ：docs/LIMITATIONS.md
統合テストレポート：docs/TEST_REPORT_2026-04-14.md
リリースチェックリスト：docs/RELEASE_CHECKLIST.md
セキュリティに関する説明：SECURITY.md
変更履歴：CHANGELOG.md

実行方法

現在のPython環境にプロジェクトの依存関係をインストールしてから実行することを推奨します：

cd /home/damoc/codes/minecraft-ops-mcp
python3 -m pip install -e .
minecraft-ops-mcp

開発やデバッグ時には、PYTHONPATH を明示的に指定することも可能です：

cd /home/damoc/codes/minecraft-ops-mcp
PYTHONPATH=src python3 -m minecraft_ops_mcp

開発とテスト

ユニットテスト：

cd /home/damoc/codes/minecraft-ops-mcp
PYTHONPATH=src python3 -B -m unittest discover -s tests

構文チェック：

python3 -m compileall -q src scripts

プロトコルレベルの統合プローブについては、docs/TEST_REPORT_2026-04-14.md および docs/RELEASE_CHECKLIST.md を参照してください。

MCPクライアント設定例

{
  "mcpServers": {
    "minecraft-ops": {
      "command": "python3",
      "args": ["-m", "minecraft_ops_mcp"],
      "cwd": "/home/damoc/codes/minecraft-ops-mcp",
      "env": {
        "PYTHONPATH": "src",
        "MCSM_BASE_URL": "http://127.0.0.1:23333",
        "MCSM_API_KEY": "replace-me",
        "MCSM_DEFAULT_DAEMON_ID": "replace-me",
        "MCSM_DEFAULT_INSTANCE_UUID": "replace-me",
        "RCON_HOST": "127.0.0.1",
        "RCON_PORT": "25575",
        "RCON_PASSWORD": "replace-me",
        "MSMP_URL": "ws://127.0.0.1:25585",
        "MSMP_SECRET": "replace-me",
        "MINECRAFT_OPS_RAW_COMMAND_ALLOWLIST": "list,time,help",
        "MINECRAFT_OPS_RAW_COMMAND_DENYLIST": "stop,op,deop,ban,ban-ip"
      }
    }
  }
}

.env.example を参考に、変数をMCPクライアントの設定に組み込むこともできます。このサービス自体は .env ファイルを自動的に読み込まないため、実行時の設定ソースが暗黙的になることを防いでいます。

主要ツール

MCSManager：

server.list_daemons
server.get_daemon_system
server.list_instances
server.get_instance
server.start
server.stop
server.restart
server.kill
server.send_command
server.get_logs
instance.create
instance.update_config
instance.update_config_patch
instance.clone_from_template
instance.delete
instance.reinstall
instance.run_update_task
file.list
file.read
file.download_prepare
file.download_local
file.upload_prepare
file.upload_local
file.upload_url
file.write
file.write_new
file.delete
file.move
file.copy
file.mkdir
file.touch
file.compress
file.uncompress

バックエンド横断型ユーティリティ：

server.save_world：MSMPを優先し、次にRCON、最後にMCSManagerを使用。
server.broadcast：MSMPを優先し、次にRCON、最後にMCSManagerを使用。

RCON：

rcon.command
rcon.list_players
rcon.time_query
rcon.save_all

MSMP：

msmp.discover
msmp.call
msmp.players.list
msmp.players.kick
msmp.server.status
msmp.server.save
msmp.server.stop
msmp.bans.get
msmp.bans.add
msmp.bans.remove
msmp.bans.set
msmp.bans.clear
msmp.ip_bans.get
msmp.ip_bans.add
msmp.ip_bans.remove
msmp.ip_bans.set
msmp.ip_bans.clear
msmp.allowlist.get
msmp.allowlist.add
msmp.allowlist.remove
msmp.allowlist.set
msmp.allowlist.clear
msmp.operators.get
msmp.operators.add
msmp.operators.remove
msmp.operators.set
msmp.operators.clear
msmp.gamerules.get
msmp.gamerules.update
msmp.server_settings.get
msmp.server_settings.list
msmp.server_settings.set

セキュリティポリシー

高リスクな操作には明示的なパラメータが必要です：

{ "confirm": true }

エージェントにまず何を行うかを説明させたい場合は、以下を渡してください：

{ "dry_run": true }

高リスクなツールには、インスタンスの起動/停止/再起動/kill、生のコマンド実行、ファイルの書き込み/削除/移動/圧縮/解凍/アップロード、MCPホストへのダウンロード、キック、BAN、ホワイトリスト/OP/ゲームルール/サーバー設定の変更などが含まれます。すべてのツール呼び出しは監査ログに記録されます。デフォルトの場所：

/tmp/minecraft-ops-mcp-audit.jsonl

MINECRAFT_OPS_AUDIT_LOG= を空に設定することで無効化できます。

生のコマンドは、プレフィックスベースの許可リスト/拒否リストを使用してさらに制限できます：

MINECRAFT_OPS_RAW_COMMAND_ALLOWLIST=list,time,help
MINECRAFT_OPS_RAW_COMMAND_DENYLIST=stop,op,deop,ban,ban-ip

バックエンドの推奨事項

インスタンスのライフサイクル、ログ、ファイル管理：MCSManager APIを優先してください。
プレイヤー、ホワイトリスト、OP、ゲームルール、サーバー設定：MSMPを優先してください。
古いバージョンのサーバーやMSMPがカバーしていない機能：RCONまたはMCSManagerのrawコマンドをフォールバックとして使用してください。

RCON、MSMP、MCSManagerのAPIキーをパブリックインターネットに公開しないでください。MSMP/RCONはlocalhost、VPN、またはトンネル経由でのみリッスンすることを推奨します。MCSManagerには権限を制限したAPIキーを使用してください。

MSMPパラメータの説明

msmp.call はJSON-RPCの params をそのまま渡すため、サーバーやバージョンによって差異がある新しいメソッドに適しています：

{
  "method": "minecraft:server/status",
  "read_only": true
}

書き込み操作を行う際は confirm=true を使用するか、事前に dry_run=true を実行してください。 read_only=true は、ホワイトリストに含まれる読み取り専用のMSMPメソッド（例：rpc.discover、minecraft:players、minecraft:server/status、リストクエリ、サーバー設定の読み取りなど）に対してのみ確認をスキップします。

Minecraft Ops MCP

Minecraft Ops MCP

ドキュメント

実行方法

開発とテスト

MCPクライアント設定例

主要ツール

セキュリティポリシー

バックエンドの推奨事項

MSMPパラメータの説明

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API