CommandNeural 是一款 PaperMC 插件,它会在你的 Minecraft 服务器上暴露一个 MCP(Model Context Protocol,模型上下文协议)HTTP 服务器。兼容 MCP 的客户端和 AI 代理可以通过此端点执行 100 多种管理工具。
什么是 MCP?
MCP 是一种用于将 AI 助手连接到外部工具的协议标准。本插件实现了 MCP 服务端,将 Minecraft 服务器操作作为可调用的工具进行暴露。
功能:
- 服务器管理 — 运行命令、读取日志、查看服务器信息、调度任务
- 玩家管理 — 列出、踢出、封禁、传送、给予物品、管理背包
- 世界编辑 — 设置方块、更改时间/天气、生成实体、创建爆炸
- 建筑 — 填充、替换、克隆、构建形状、支持 WorldEdit 原理图
- 插件集成(检测到 16 个):WorldGuard 区域、LuckPerms 权限、Vault 经济、PlaceholderAPI、Oraxen 物品、Citizens NPC、CoreProtect、EssentialsX、GriefPrevention、MythicMobs、DiscordSRV、UnlimitedNameTags 等
- 文件系统访问 — 读取、写入、编辑、搜索、下载(沙盒限制在服务器目录内)
- 数据库查询 — 通过 JDBC 执行 SQL
- NBT 操作 — 修改物品和实体的 NBT 数据
安全性:
- 基于 Token 的身份验证
- 按 IP 限流
- 按工具权限开关(可在 config.yml 中配置)
- 文件沙盒将操作限制在服务器根目录
- 危险命令黑名单
- 完全访问模式(默认禁用,绕过所有权限检查)
- 支持 TLS/HTTPS,并自动生成自签名密钥库
兼容性:
- Paper 1.16.5+(Java 21)
- Folia(通过反射自动检测)
- 同样适用于 Purpur 和 Spigot
使用方法:
- 将 JAR 文件放入
plugins/ 文件夹
- 启动服务器以生成
plugins/CommandNeural/config.yml
- 在 config.yml 中配置你的认证 Token
- 从任何兼容 MCP 的客户端连接到
http://your-server:8765/mcp
CommandNeural is a PaperMC plugin that exposes an MCP (Model Context Protocol) HTTP server on your Minecraft server. MCP-compatible clients and AI agents can use this endpoint to execute 100+ administration tools over HTTP.
What is MCP?
MCP is a protocol standard for connecting AI assistants to external tools. This plugin implements the MCP server side, exposing Minecraft server operations as callable tools.
Features:
- Server management — run commands, read logs, view server info, schedule tasks
- Player management — list, kick, ban, teleport, give items, manage inventories
- World editing — set blocks, change time/weather, spawn entities, create explosions
- Construction — fill, replace, clone, build shapes, WorldEdit schematic support
- Plugin integrations (16 detected): WorldGuard regions, LuckPerms permissions, Vault economy, PlaceholderAPI, Oraxen items, Citizens NPCs, CoreProtect, EssentialsX, GriefPrevention, MythicMobs, DiscordSRV, UnlimitedNameTags, and more
- File system access — read, write, edit, search, download (sandboxed to server directory)
- Database queries — execute SQL via JDBC
- NBT manipulation — modify item and entity NBT data
Security:
- Token-based authentication
- Per-IP rate limiting
- Per-tool permission toggles (configurable in config.yml)
- File sandbox restricts operations to server root
- Command blacklist for dangerous commands
- Full-access mode (disabled by default, bypasses all permission checks)
- TLS/HTTPS support with auto-generated self-signed keystore
Compatibility:
- Paper 1.16.5+ (Java 21)
- Folia (auto-detected via reflection)
- Also works on Purpur and Spigot
How to use:
- Place the JAR in your
plugins/ folder
- Start the server to generate
plugins/CommandNeural/config.yml
- Configure your auth token in config.yml
- Connect from any MCP-compatible client to
http://your-server:8765/mcp
评论 0
登录后参与评分
还没有评论,来抢沙发吧