minecraft-document-mcp

[](https://www.python.org/) [](https://github.com/jlowin/fastmcp) [](LICENSE)

一个基于 FastMCP 框架的 Minecraft 文档 MCP 服务器，为 AI 助手提供 Minecraft 游戏文档查询功能。

• 本地文档查询 - 查询本地存储的 Minecraft 文档（命令列表等）
• Wiki 在线查询 - 从中文 Minecraft Wiki 获取词条内容
• Markdown 输出 - 所有查询结果以 Markdown 格式返回
• MCP 协议支持 - 兼容 Model Context Protocol，可集成到 Claude Desktop 等客户端

| 工具名称 | 功能描述 | |---------|---------| | get_available_info | 获取本地文档的分类和版本信息 | | get_all_partial_info | 获取所有本地文档的摘要列表 | | get_document_context | 根据分类、版本、名称获取完整文档内容 | | search_wiki_intro | 从 Wiki 搜索词条简介 | | search_wiki_full | 从 Wiki 搜索词条完整内容 |

• Python 3.12+
• uv 包管理器（推荐）

# 克隆仓库
git clone https://github.com/PYmili/minecraft-document-mcp.git
cd minecraft-document-mcp

# 安装依赖
uv sync

# 克隆仓库
git clone https://github.com/PYmili/minecraft-document-mcp.git
cd minecraft-document-mcp

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# 安装依赖
pip install -r requirements.txt

# SSE 传输模式
python server.py

# 或使用 fastmcp 开发模式
fastmcp dev server.py

在 Claude Desktop 配置文件中添加：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "minecraft-document": {
      "command": "python",
      "args": ["/path/to/minecraft-document-mcp/server.py"]
    }
  }
}

minecraft-document-mcp/
├── server.py                    # MCP 服务器入口
├── pyproject.toml               # 项目配置
└── src/
    ├── mcp/
    │   ├── dto/                 # 数据传输对象
    │   ├── entity/              # 实体类
    │   ├── request/