Minecraft MCP 服务器

Minecraft-MCP-Server

一个用Python编写的MCP服务器，旨在通过RCON控制Minecraft服务器，利用FastMCP实现无缝集成和命令执行。

🔧 特性

• 命令字典：提供一套全面的命令，以增强与Minecraft服务器的交互。
• RCON执行：通过RCON直接在Minecraft服务器上执行命令，实现实时控制。
• 客户端集成：与Claude Desktop或任何MCP客户端兼容，便于管理。
• 灵活结构：支持通过stdio进行本地开发，并通过HTTP/SSE支持生产环境。

📦 项目结构

mcp_server/
├── commands.json         # 包含命令及其使用示例  
├── server.py             # MCP的主要服务器脚本  
├── commands.json         # Minecraft命令以便于理解上下文  
└── (venv/)               # 可选的虚拟环境用于依赖  

⚙️ 安装

1. 克隆仓库：

   cd Minecraft-MCP-Server/mcp_server
   

2. 设置环境并安装依赖：

   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服务器。

📚 参考资料

• FastMCP v2 – 示例README
• mcrcon – Python RCON客户端

🛠 下一步

• 实现使用Docker的HTTP/SSE传输支持。
• 通过命令字典增强参数验证和自动完成功能。
• 添加日志记录以记录额外操作，如/start、/stop、/backup和/whitelist。

准备好提升您的Minecraft服务器体验！🚀