MCSManager MCP Server
MCSManager MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,为 AI Agent 提供对 MCSManager 的访问能力。通过此服务器,AI Agent 可以管理 Minecraft 服务器实例、文件、计划任务等。
功能特性
节点管理:列出所有守护进程节点
实例管理:列出、启动、停止、重启、删除 Minecraft 服务器实例
文件管理:列出、创建、删除文件和目录,读取和写入文件内容
计划任务:列出、创建、删除计划任务
用户管理:列出、创建、更新、删除用户
备份管理:创建、列出、删除、恢复实例备份
使用方式
配置环境变量
在运行服务器之前,需要设置以下环境变量:
MCSM_API_URL:MCSManager 前端面板地址(例如:http://192.168.9.121:23333)MCSM_API_KEY:从面板用户设置中生成的 API 密钥
运行服务器
STDIO 模式:适用于本地开发和调试
HTTP/SSE 模式:推荐用于生产环境,默认监听端口 3009(开发中)
与 AI Agent 集成
通过 iFlow CLI 或其他支持 MCP 的工具添加此服务器:
可使用本地路径、开发模式或全局安装方式运行
开发部署
安装依赖
构建项目
运行开发模式(支持热重载)
项目使用 TypeScript 编写,支持 STDIO 和 HTTP/SSE 两种传输模式,便于与不同的 AI Agent 平台集成。
MCP 配置文件示范
iFlow CLI 配置示例
1. 使用本地路径(开发环境)
2. 使用开发模式(使用 tsx)
3. 全局安装后使用
4. 通过前端远程连接(推荐方式)
Cursor AI 配置示例
在 Cursor 的 MCP 配置文件中添加(通常位于 ~/.cursor/mcp.json):
本地运行方式(需要本地安装MCP Server)
HTTP远程连接方式(推荐)
说明:
本地运行方式:将MCP Server作为本地进程运行
HTTP远程连接方式:通过HTTP/HTTPS连接到MCP Server
重启 Cursor 后,AI 助手将能够访问 MCSManager 的所有功能。
Claude Desktop 配置示例
在 Claude Desktop 的配置文件中添加(通常位于 ~/.claude/mcp.json):
或者使用 HTTP 远程连接方式:
说明:
配置完成后需要重启 Claude Desktop 才能生效
确保 MCP Server 正在运行且网络连接正常
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables AI agents to manage Minecraft servers through MCSManager, including instance control (start/stop/restart), file management, scheduled tasks, user management, and backup operations.