Minecraft MCPサーバー

Minecraft-MCP-Server

RCONを介してMinecraftサーバーを制御するために設計されたPython MCPサーバーで、FastMCPを利用してシームレスな統合とコマンド実行を実現します。

🔧 機能

コマンド辞書: Minecraftサーバーとのインタラクションを強化するための包括的なコマンドセットを提供します。
RCON実行: RCONを使用してMinecraftサーバー上でコマンドを直接実行し、リアルタイムで制御します。
クライアント統合: Claude Desktopまたは任意のMCPクライアントと互換性があり、簡単に管理できます。
柔軟な構造: stdioを介したローカル開発とHTTP/SSEを介した本番環境の両方をサポートします。

📦 プロジェクト構造

mcp_server/
├── commands.json         # 使用例を含むコマンドの内容  
├── server.py             # MCPのメインサーバースクリプト  
├── commands.json         # 文脈理解のためのMinecraftコマンド  
└── (venv/)               # 依存関係のためのオプションの仮想環境

⚙️ インストール

リポジトリをクローンします:
```
cd Minecraft-MCP-Server/mcp_server
```

環境を設定し、依存関係をインストールします:

python -m venv venv
venv\Scripts\activate
pip install mcp[cli] mcrcon

📝 セットアップ

commands.jsonファイルには、/give、/weather、/gamemodeなどのさまざまなコマンドが含まれており、説明と使用例が付いています。

Minecraftのserver.propertiesファイルでRCONが有効になっていることを確認してください:

enable-rcon=true
rcon.password=minemcp
rcon.port=25575

🚀 サーバーの実行

サーバーを起動するには、仮想環境をアクティブにし、次のコマンドを実行します:

venv\Scripts\activate
python server.py

デフォルトでは、MCPサーバーはSTDIOモードで起動します。

⚙️ Claude Desktopとの統合

Claude Desktopと統合するには、claude_desktop_config.jsonファイルを変更します（%APPDATA%\Claude\にあります）:

{
  "mcpServers": {
    "minecraft-controller": {
      "type": "stdio",
      "command": "C:\\...\\venv\\Scripts\\python.exe",
      "args": ["C:\\...\\mcp_server\\server.py"],
      "env": {"PATH": "%PATH%"}
    }
  }
}

Claudeを再起動して、‘minecraft-controller’サーバーがリストに表示されることを確認してください。

🧪 Pythonによるローカルテスト

次のPythonスクリプトを使用して、サーバーをローカルでテストできます:

from fastmcp import Client
import asyncio

async def test():
    client = Client("mcp_server/server.py")
    async with client:
        res = await client.call_tool("run_minecraft_command", {"command": "/list"})
        print("プレイヤー:", res)
        cmds = await client.read_resource("minecraft://commands")
        print("コマンド:", list(cmds.keys())[:5])

asyncio.run(test())

🧰 仕組み

FastMCP機能: 効率的なコマンド処理のためにツールとリソースを自動的にロードします。
コマンドリソース: リソースminecraft://commandsは、利用可能なコマンドの辞書を提供します。
コマンド実行: ツールrun_minecraft_commandは、mcrconを利用してMinecraftサーバーにコマンドを送信します。

📚 参考文献

🛠 次のステップ

Dockerを使用してHTTP/SSEトランスポートのサポートを実装します。
コマンド辞書を介して引数の検証とオートコンプリート機能を強化します。
/start、/stop、/backup、/whitelistなどの追加アクションのログを追加します。

概要