mcsm-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCSM_HOST | No | http 监听地址 | 127.0.0.1 |
| MCSM_PORT | No | http 监听端口 | 8000 |
| MCSM_API_KEY | No | 面板 API Key (v10 推荐) | |
| MCSM_TIMEOUT | No | 面板请求超时(秒) | 15 |
| MCSM_BASE_URL | No | 面板地址(不带末尾斜杠) | http://127.0.0.1:23333 |
| MCSM_ENV_FILE | No | 指定 .env 文件路径(可选) | .env |
| MCSM_PASSWORD | No | 面板密码 (v9) | |
| MCSM_USERNAME | No | 面板用户名 (v9) | |
| MCSM_TRANSPORT | No | stdio 或 http | stdio |
| MCSM_ALLOW_WRITE | No | 写操作开关(0=只读,1=允许启动/停止等) | 0 |
| MCSM_OPERATION_WAIT | No | mcs_wait_for_status 默认等待上限(秒) | 600 |
| MCSM_BLOCKED_COMMANDS | No | 危险指令黑名单(按首词匹配) | stop,restart |
| MCSM_COMMAND_WHITELIST | No | 控制台指令白名单(逗号分隔前缀;空=全部允许) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mcs_list_instancesA | 列出 MCSManager 面板上的所有 Minecraft 服务器实例,包括名称、运行状态、在线玩家数、端口。用于回答「有哪些服务器」「服务器列表」「各服务器现在什么状态」等问题。返回结构化列表 JSON。 |
| mcs_instance_statusA | 查询指定 Minecraft 服务器实例的运行状态与详情,包括运行状态、在线玩家数、端口、启动命令。用于回答「XX服务器状态怎么样」「XX服在线多少人」「XX服开没开」等问题。 Args: instance_name: 服务器实例名称(MCSManager 中配置的昵称)或实例 UUID,如 生存服、SMP、我的世界主服 |
| mcs_start_instanceA | 启动指定的 Minecraft 服务器实例。启动在 MCS 后台异步执行,指令下发后立即返回;如需确认启动完成,可随后调用 mcs_wait_for_status(instance_name, "running")。用于「启动XX服务器」「把XX服开起来」等请求。 Args: instance_name: 服务器实例名称(MCSManager 中配置的昵称)或实例 UUID,如 生存服、SMP、我的世界主服 |
| mcs_stop_instanceA | 正常停止指定的 Minecraft 服务器实例(向服务端发送停止指令,可安全存档)。停止为后台异步执行;如需确认完成,可随后调用 mcs_wait_for_status(instance_name, "stopped")。用于「关掉XX服」「把XX服务器停下来」等请求。 Args: instance_name: 服务器实例名称或实例 UUID,如 生存服、SMP |
| mcs_restart_instanceA | 重启指定的 Minecraft 服务器实例。重启为后台异步执行;如需确认完成,可随后调用 mcs_wait_for_status(instance_name, "running")。用于「重启一下XX服」「XX服务器卡了,重启一下」等请求。 Args: instance_name: 服务器实例名称或实例 UUID,如 生存服、SMP |
| mcs_kill_instanceA | 强制停止指定的 Minecraft 服务器实例(直接杀进程,可能丢失未保存数据,仅建议在正常停止无效时使用)。用于「强制关掉XX服」「XX服卡死了,强停一下」等请求。 Args: instance_name: 服务器实例名称或实例 UUID,如 生存服、SMP |
| mcs_exec_commandA | 向指定的 Minecraft 服务器实例发送控制台指令,如 say 发送公告、list 查看在线玩家、op 设置管理员、whitelist 管理白名单、give 发放物品、tp 传送、kick/ban 管理玩家、time/weather/gamemode/difficulty 等。指令在服务端控制台执行。用于「给XX服发个公告」「在XX服执行 op Steve」「把某人加进XX服白名单」「XX服有多少人在线」等请求。 Args: instance_name: 服务器实例名称或实例 UUID,如 生存服、SMP command: 控制台指令(不含 / 前缀),如 say 大家好、list、op Steve、whitelist add Steve |
| mcs_wait_for_statusA | 等待指定服务器实例达到目标状态(每 5 秒轮询一次),用于启动/停止/重启后确认操作完成——替代原插件“后台推送通知”能力。达到目标状态返回 reached=true,超时返回 reached=false 并附当前状态。 Args: instance_name: 服务器实例名称或实例 UUID,如 生存服、SMP target_status: 目标状态:running(运行中)或 stopped(已停止),也接受中文 运行中/已停止 timeout_seconds: 最长等待秒数(默认 300,范围 5~1800) |
| mcs_get_configA | 查看当前 MCP Server 生效的配置:面板地址、读写开关、指令白/黑名单、传输方式等(API Key 与密码已脱敏为 ***)。用于确认 Server 当前配置状态,或修改 .env 后核对是否生效。 |
| mcs_reload_configA | 重新加载配置(.env 文件或环境变量),不需要重启 Server 即可生效。修改 .env 后调用本工具立即热更新;也可传 env_file 切换到另一个配置文件。 Args: env_file: 可选的 .env 文件路径(留空则沿用启动时使用的路径;纯环境变量模式则重读当前环境变量) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/siwuli/mcp-server-mcs-manager'
If you have feedback or need assistance with the MCP directory API, please join our Discord server