](https://smithery.ai/server/@nacal/mcp-minecraft-remote) ](https://mseep.ai/app/nacal-mcp-minecraft-remote)
MCP Minecraft遥控器
这个项目的灵感来自 mcp扫雷艇 通过arjunkmrm。虽然最初的版本只支持本地Minecraft服务器连接，但这个项目是从头开始创建的，以添加对连接到远程Minecraft服务器的支持。
使用MCP（模型上下文协议）的Minecraft远程控制。
特性
- 通过AI助手连接并控制Minecraft玩家
- 导航、挖掘、构建Minecraft世界并与之互动
- 与服务器上的其他玩家聊天
- 检查库存、玩家位置和服务器信息
- 先进的运动控制，包括跳跃、潜行和冲刺
- 实体交互，包括攻击和跟踪
- 容器使用（箱子、炉子等）
- 物品制作和村民交易
- 详细的库存管理
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面版Minecraft遥控器 史密瑟里:
npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude快速安装（推荐）
npx -y @smithery/cli install mcp-minecraft-remote --client claude按照CLI提示完成设置。
手动安装
# Install from npm
npm install -g mcp-minecraft-remote
# Or clone the repository
git clone https://github.com/nacal/mcp-minecraft-remote.git
cd mcp-minecraft-remote
# Install dependencies
npm install
# Build the project
npm run build用法
与Claude Desktop一起使用
- 导航到Claude Desktop配置文件：
- 窗户： %APPDATA%\Claude\claude_desktop_config.json - macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json
- 将Minecraft Remote MCP配置添加到您的配置文件中：
{
"mcpServers": {
"minecraft-remote": {
"command": "npx",
"args": ["-y", "mcp-minecraft-remote@latest"]
}
}
}如果您已全局安装：
{
"mcpServers": {
"minecraft-remote": {
"command": "mcp-minecraft-remote"
}
}
}如果您已在本地克隆了存储库：
{
"mcpServers": {
"minecraft-remote": {
"command": "node",
"args": ["/absolute/path/to/mcp-minecraft-remote/build/index.js"]
}
}
}- 保存文件并重新启动Claude Desktop
- 与Claude开始新的对话，并开始使用Minecraft控制命令
重要服务器要求
- 服务器联机模式：Minecraft服务器必须具有
online-mode=false在server.properties文件中设置。这允许机器人无需对Minecraft的会话服务器进行身份验证即可连接。 - 如果使用具有身份验证的服务器，则在连接时需要提供有效的高级帐户凭据。
可用工具
核心功能
connectToServer：使用指定凭据连接到Minecraft服务器disconnectFromServer：断开与Minecraft服务器的连接sendChat：向服务器发送聊天消息getServerInfo：获取有关已连接服务器的信息
运动
getPosition：获取当前玩家位置moveTo：移动到特定坐标moveControl：基本动作控制（前进、后退、左、右、跳跃、冲刺、潜行、停止）lookAt：让玩家看向特定方向或坐标
世界互动
digBlock：在特定坐标处挖掘一个区块placeBlock：在特定坐标处放置一个块
库存管理
checkInventory：基本库存检查inventoryDetails：获取库存物品的详细信息equipItem：将库存中的物品装备到手边或护甲槽中tossItem：从库存中丢弃物品
实体交互
getNearbyPlayers：获取附近玩家列表getNearbyEntities：获取附近所有实体的列表attackEntity：攻击特定实体useOnEntity：在特定实体上使用保留项followEntity：关注特定实体
容器交互
openContainer：在特定坐标处打开容器（箱子、炉子等）withdrawItem：从敞口容器中取出物品depositItem：将物品放入敞口容器中closeContainer：关闭当前打开的容器
制作
getRecipes：获取可用制作食谱列表craftItem：使用可用材料制作物品
交易
listTrades：列出附近村民的可用交易tradeWithVillager：与附近的村民进行贸易
示例提示
基本控制
- “使用用户名player1连接到play.example.com上的Minecraft服务器”
- “我目前在游戏中的位置是什么？”
- 将我移动到坐标x=100，y=64，z=-200
- “让我向前走3秒钟”
- “让我跳起来，朝那座山冲刺”
库存和物品
- “详细检查我的库存中有什么”
- “把我的钻石剑放在我手里”
- “从我的库存中扔5个脏块”
块交互
- 在坐标x=10、y=65、z=20处挖掘该块
- 在坐标x=11，y=65，z=20处放置一块石块
实体交互
- “附近还有其他玩家吗？”
- “距离我20个街区内有哪些实体？”
- “攻击ID为12345的僵尸”
- “跟随名为Steve的玩家”
容器使用情况
- 在坐标x=100，y=64，z=200处打开胸部
- “从箱子里拿出10块铁锭”
- “往箱子里放5块鹅卵石”
- “关闭容器”
工艺与贸易
- “我有什么木制镐的食谱？”
- “使用我库存中的木材制作4根棍子”
- “检查附近村民提供的交易”
- “与村民交易，得到10颗祖母绿”
沟通
- “向聊天室发送问候消息”
- “告诉大家我找到了钻石”
需求
- Node.js 18+
- 支持MCP的AI助手（如Claude）
- Minecraft Java版服务器（1.8或更高版本）
备注：此工具已经过测试和验证，可以专门用于原版Minecraft 1.21。虽然它可以与其他版本或改装服务器一起使用，但不保证兼容性。
许可证
麻省理工学院