Minecraft MCP Server

Minecraft MCP Server

一个早期的模型上下文协议(MCP)服务器实现原型,集成了Mineflayer API以与Minecraft进行交互。

Minecraft MCP 服务器使用指南

简介

这是一个早期的模型上下文协议 (MCP)服务器实现原型,集成了Mineflayer API 来与Minecraft进行交互。

快速开始

  1. 安装依赖

    npm install
    
  2. 启动服务器

    npm start
    
  3. 连接到 Minecraft 服务器

    # 在配置文件中设置您的 Minecraft 服务器信息
    # 或使用命令行参数:
    npm start -- --host mc.example.com --port 25565 --username bot1
    
  4. 使用 MCP 客户端连接

    # 默认 MCP 服务器端口为 8000
    # 连接地址:ws://localhost:8000
    

主要功能

  • Minecraft 世界探索
  • 方块操作和交互
  • 物品管理
  • 实体检测

配置选项

参数描述默认值
--hostMinecraft 服务器地址localhost
--portMinecraft 服务器端口25565
--username机器人用户名mcp_bot
--mcp-portMCP 服务器端口8000

注意事项

  • 这是一个原型实现,可能存在稳定性问题
  • 需要有效的 Minecraft 账户才能连接到正版服务器
  • 支持离线模式服务器