用途
crafty-mcp 是一个 MCP（模型上下文协议）服务器，用于连接 Crafty Controller 4，让 AI 助手（如 Claude）能够通过自然语言管理 Minecraft 服务器。它暴露了 Crafty Controller 4 API V2 的完整功能作为 MCP 工具，使用户可以在 AI 聊天界面中直接完成服务器管理任务。
主要能力
该工具提供的 MCP 工具覆盖以下方面：
- Crafty Host（系统）：系统级别的管理操作。
- 服务器 — CRUD 与信息：服务器的创建、读取、更新、删除以及信息查询。
- 服务器 — 运行时与日志：查看服务器运行状态和日志。
- 服务器 — 操作：执行启动、停止等服务器操作。
- 服务器 — 控制台：发送控制台命令，管理玩家。
- 服务器 — 文件：编辑服务器文件。
- 服务器 — 备份：配置和管理备份。
- 服务器 — 计划任务：设置定时任务。
- 服务器 — Webhook：管理 Webhook。
- 用户管理：管理用户账户。
具体包括：启动和停止服务器、发送控制台命令、管理玩家、编辑服务器文件、配置备份、设置计划任务、管理 Webhook 以及管理用户。
使用方式
-
在 MCP 客户端配置中添加 crafty-mcp。
- Claude Desktop：配置文件位于 macOS 的
~/Library/Application Support/Claude/claude_desktop_config.json或 Windows 的%APPDATA%\Claude\claude_desktop_config.json。 - Cursor：配置文件位于
.cursor/mcp.json。
- Claude Desktop：配置文件位于 macOS 的
-
获取 API 令牌（可选但推荐）：
- 在浏览器中打开 Crafty Controller。
- 点击用户名 -> Profile。
- 滚动到 API Keys 部分。
- 点击 Generate Key。
- 复制令牌，并将其用作
CRAFTY_API_TOKEN。 - 超级用户令牌拥有所有服务器和操作的完整访问权限。
CRAFTY_API_TOKEN是可选的，如果使用crafty_login工具进行动态身份验证，但大多数设置推荐使用它。
适用场景
适用于需要通过 AI 助手（如 Claude）以自然语言管理 Minecraft 服务器的用户，尤其是使用 Crafty Controller 4 进行服务器管理的场景。可以在不离开 AI 聊天的情况下完成服务器启停、命令发送、文件编辑、备份配置、计划任务和 Webhook 管理等操作。
限制
- 需要 Crafty Controller 4 环境。
- 需要配置 MCP 客户端。
- 如果使用 API 令牌，超级用户令牌具有完全访问权限，需注意安全。
- 该工具采用 AGPL-3.0-or-later 许可证，版权归 Hadi Cherkaoui 所有（Copyright (C) 2026 Hadi Cherkaoui），详见 LICENSE 文件。
其他具体限制或要求暂未提供。
