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