MineMCP
一个 Minecraft Paper 插件,实现了 Model Context Protocol (MCP) 服务器,使 AI 代理能够通过 HTTP 控制和监控 Minecraft 1.21 服务器。
?️ 可用工具
世界操作
pose_block- 在指定坐标放置方块break_block- 在指定坐标破坏方块fill_block- 用方块填充区域
命令执行
execute_command- 执行任意 Minecraft 命令并捕获输出
文件系统
read_file- 读取服务器上的文本文件write_file- 将文本写入服务器read_file_base64- 以 Base64 格式读取二进制文件write_file_base64- 从 Base64 写入二进制文件list_directory- 列出目录内容
服务器信息
list_plugins- 获取所有已安装的插件get_logs- 检索最近的服务器日志get_online_players- 列出所有在线玩家get_player- 获取特定玩家的详细信息(生命值、物品栏、位置、效果等)
? 要求
- Java 21 或更高版本
- Minecraft 1.21 服务器
- Paper 或 Purpur 服务器软件(Spigot 可能可用,但未官方支持)
? 安装
下载预构建 JAR
- 从 Releases 页面下载最新版本
- 将
MineMCP-1.0.0-all.jar放入服务器的plugins/文件夹 - 启动/重启服务器
- 在
plugins/MineMCP/config.yml中配置令牌
⚙️ 配置
首次运行后,编辑 plugins/MineMCP/config.yml:
server:
port: 3000
token: "your-secret-token-here" # 请更改为安全的随机令牌!
重要提示:请务必更改默认令牌以确保安全!
生成安全令牌
# Linux/macOS
openssl rand -hex 32
# 或使用任何密码生成器创建强令牌
? 用法
启动服务器
- 启动安装了 MineMCP 的 Minecraft 服务器
- MCP 服务器将在端口 3000 上自动启动(可配置)
- 检查控制台是否显示:
[MineMCP] MCP server started on port 3000
使用 MCP 客户端连接
使用带有 MCP 扩展的 VS Code
在项目中的 .vscode/mcp.json 创建或编辑文件:
{
"mcpServers": {
"minecraft": {
"url": "http://localhost:3000/sse?token=your-secret-token-here"
}
}
}
? API 示例
执行命令
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "execute_command",
"arguments": {
"command": "time set day"
}
}
}
放置方块
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "pose_block",
"arguments": {
"world": "world",
"x": 100,
"y": 64,
"z": 200,
"material": "DIAMOND_BLOCK"
}
}
}
获取玩家信息
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_player",
"arguments": {
"player": "PlayerName",
...
}
}
}
? 安全注意事项
- 令牌保护:切勿将令牌提交到版本控制系统
- 网络安全:默认情况下,服务器绑定到
0.0.0.0(所有接口) - 防火墙规则:限制端口 3000 仅允许受信任的 IP 访问
- 文件系统访问:工具可以访问整个服务器目录——请谨慎使用
? 贡献
欢迎贡献!请遵循以下步骤:
- Fork 仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开 Pull Request
添加新工具
- 在
src/main/java/me/axeno/minemcp/tools/impl/中创建继承自McpTool的新类 - 实现所需的方法 (
getSchema()和execute()) - 在
ToolHandler.java构造函数中注册工具
示例:
public class MyTool extends McpTool {
public MyTool() {
super("my_tool", "Description of my tool");
}
@Override
public ObjectNode getSchema() {
ObjectNode schema = mapper.createObjectNode();
schema.put("type", "object");
// 定义你的模式...
return schema;
}
@Override
public ObjectNode execute(JsonNode args) throws Exception {
CompletableFuture<String> future = new CompletableFuture<>();
Bukkit.getScheduler().runTask(MineMCP.getInstance(), () -> {
try {
// 在这里进行 Bukkit 操作
future.complete("Success!");
} catch (Exception e) {
future.completeExceptionally(e);
}
});
String result = future.get(10, TimeUnit.SECONDS);
return createTextResult(result);
}
}
? 许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
? 支持
- 问题反馈: GitHub Issues
由 ❤️ 为 Minecraft 和 AI 社区打造
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧