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 的工具添加此服务器：

可使用本地路径、开发模式或全局安装方式运行

开发部署

安装依赖

npm install

构建项目

npm run build

运行开发模式（支持热重载）

npm run dev:stdio    # STDIO 模式
npm run dev:http     # HTTP/SSE 模式

项目使用 TypeScript 编写，支持 STDIO 和 HTTP/SSE 两种传输模式，便于与不同的 AI Agent 平台集成。

MCP 配置文件示范

iFlow CLI 配置示例

1. 使用本地路径（开发环境）

iflow mcp add-json -s user 'mcsmanager' '{
  "command": "node",
  "args": ["/path/to/mcp-server/dist/index.js"],
  "env": {
    "MCSM_API_URL": "http://192.168.9.121:23333",
    "MCSM_API_KEY": "your_api_key_here"
  }
}'

2. 使用开发模式（使用 tsx）

iflow mcp add-json -s user 'mcsmanager' '{
  "command": "npx",
  "args": ["-y", "tsx", "/path/to/mcp-server/src/index.ts"],
  "env": {
    "MCSM_API_URL": "http://192.168.9.121:23333",
    "MCSM_API_KEY": "your_api_key_here"
  }
}'

3. 全局安装后使用

iflow mcp add-json -s user 'mcsmanager' '{
  "command": "mcsmanager-mcp",
  "env": {
    "MCSM_API_URL": "http://192.168.9.121:23333",
    "MCSM_API_KEY": "your_api_key_here"
  }
}'

4. 通过前端远程连接（推荐方式）

iflow mcp add-json -s user 'mcsmanager' '{
    "mcsm-remote": {
      "url": "https://127.0.0.1:3009/mcp",
      "headers": {
        "MCSM_API_URL": "http://127.0.0.1:3009",
        "MCSM_API_KEY": "d3f467e1aaed4481b6e83043dbc4bbab"
      }
    }
}'

Cursor AI 配置示例

在 Cursor 的 MCP 配置文件中添加（通常位于 ~/.cursor/mcp.json）：

本地运行方式（需要本地安装MCP Server）

{
  "mcpServers": {
    "mcsmanager": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "MCSM_API_URL": "http://192.168.9.121:23333",
        "MCSM_API_KEY": "your_api_key_here"
      }
    }
  }
}

HTTP远程连接方式（推荐）

{
  "mcpServers": {
    "mcsmanager": {
      "url": "http://127.0.0.1:3009/mcp",
      "headers": {
        "MCSM-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

说明：

本地运行方式：将MCP Server作为本地进程运行
HTTP远程连接方式：通过HTTP/HTTPS连接到MCP Server
重启 Cursor 后，AI 助手将能够访问 MCSManager 的所有功能。

Claude Desktop 配置示例

在 Claude Desktop 的配置文件中添加（通常位于 ~/.claude/mcp.json）：

{
  "mcpServers": {
    "mcsmanager": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "MCSM_API_URL": "http://192.168.9.121:23333",
        "MCSM_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者使用 HTTP 远程连接方式：

{
  "mcpServers": {
    "mcsmanager": {
      "url": "http://127.0.0.1:3009/mcp",
      "headers": {
        "MCSM-API-KEY": "YOUR_API_KEY"
      }
    }
  }
}

说明：

配置完成后需要重启 Claude Desktop 才能生效
确保 MCP Server 正在运行且网络连接正常

MCP Servers