aiplayer-mc-bot MCP Server
Enables natural language control of a Minecraft bot, allowing it to execute tasks like mining, exploring, and item management via AI-powered commands.
README
AIPlayer — 你的 Minecraft AI 队友
一个能听懂中文的 Minecraft 机器人。你在游戏里打字说"帮我挖钻石"，它就自动规划并执行。
它能做什么
- 🎯 听懂中文指令 — "过来"、"挖钻石"、"看看周围有什么"
- 🧭 自主探索 — 移动、挖掘、放置方块、查询位置
- 🧠 记住上次的事 — 退出后自动总结，下次加载
- ⚡ 快捷指令 — 终端输入
!坐标、!血量，实时反馈 - 📦 物品知识库 — 知道每种物品的堆叠上限
你需要准备
| 项目 | 说明 |
|---|---|
| Minecraft 服务器 | Java版 1.21.1，本地运行 |
| Node.js | 18+ |
| Python | 3.10+ |
| DeepSeek API Key | 用于 AI 决策 |
快速开始
1. 下载项目
git clone https://github.com/你的用户名/aiplayer-mc-bot.git
cd aiplayer-mc-bot
2. 安装依赖
# Node.js 依赖
npm install
# Python 依赖
pip install fastmcp sentence-transformers scikit-learn tiktoken openai
3. 下载 AI 模型
项目需要嵌入模型来进行语义匹配，约 500MB：
python -c "from sentence_transformers import SentenceTransformer; SentenceTransformer('paraphrase-multilingual-MiniLM-L12-v2', cache_folder='./EembeddingModelFiles')"
4. 设置 API Key
set DeepSeek_API_KEY=sk-你的key
5. 配置存档目录
把你玩的世界存档放到项目同层目录下：
你的目录/
├── world1/ ← 你的存档（level.dat 所在文件夹）
│ └── level.dat
├── world2/ ← 另一个存档
└── aiplayer-mc-bot/ ← 项目文件夹（你刚下载的）
6. 启动
终端 1 — 启动 Python MCP 服务：
cd Python
python server_of_mcp.py
终端 2 — 启动 Bot：
node MainLoop.js
启动后终端会显示存档列表，输入编号选择当前要玩的存档即可。
在游戏里使用
自然语言指令（直接打字）
你: 帮我看看我在什么位置
Bot: 我在 (100, 64, 200)
你: 挖点钻石回来
Bot: 好的，我先装备铁镐...
快捷指令（终端输入，不进游戏）
| 输入 | 效果 |
|---|---|
!坐标 |
显示当前位置 |
!血量 |
显示血量和饱食度 |
!背包 |
显示背包物品 |
!物品 |
显示手持物品 |
!附近实体 |
显示周围生物 |
保存技能（游戏内聊天）
完成任务后说"保存 技能名"，Bot 会自动记住操作流程，下次可以直接复用。
常见问题
Q: Bot 连不上服务器？ 确保 Minecraft 服务器已启动，地址为 localhost:25565，开启离线模式。
Q: 提示 DeepSeek_API_KEY 未设置？ 参考步骤 4 设置环境变量。
Q: 输入 !坐标 没反应？ 快捷指令是在启动 Bot 的终端窗口输入的，不是在游戏聊天框。
Q: 启动时没有看到我的存档？ 确保你的存档文件夹在项目目录的上级目录中（和项目文件夹同级）。
项目状态
⚠️ Demo / Work in Progress — 核心功能可用，图形界面尚未完成。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.