Skip to main content
Glama
deenesjakoruzh
siwuli

mcsm-mcp

by siwuli
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcsm-mcp —— Servidor MCP de gestión de servidores Minecraft para MCSManager

Servidor MCP independiente convertido a partir del plugin de AstrBot siwu-mcs-manager-1_0 (plugin original AstrBot_siwu-mcs-manager): gestiona instancias de servidores Minecraft (listado / estado / inicio / detención / reinicio / detención forzada / comandos de consola) a través de la API del panel MCSManager, listo para usar con cualquier cliente compatible con MCP (Claude Desktop, IDE, frameworks de agentes, etc.).

Resumen de herramientas (10)

Herramienta

Descripción

mcs_list_instances

Lista todas las instancias de servidor (nombre/estado/jugadores en línea/puerto)

mcs_instance_status

Consulta el estado detallado de una instancia específica (estado/jugadores en línea/puerto/comando de inicio)

mcs_start_instance

Inicia la instancia especificada (ejecución asíncrona en segundo plano)

mcs_stop_instance

Detiene normalmente la instancia especificada (guardado seguro)

mcs_restart_instance

Reinicia la instancia especificada

mcs_kill_instance

Detiene forzosamente la instancia especificada (mata el proceso, puede perder datos)

mcs_exec_command

Envía comandos de consola a la instancia (say/op/whitelist/give/tp/list, etc.)

mcs_wait_for_status

Sondea en espera hasta que la instancia alcanza el estado objetivo (sustituye a las notificaciones push del plugin)

mcs_get_config

Muestra la configuración actualmente activa (API Key/contraseña enmascarados)

mcs_reload_config

Recarga la configuración en caliente (sin reiniciar tras editar .env), también permite cambiar de archivo de configuración

Related MCP server: MCSManager MCP Server

Diferencias con el plugin original

Plugin original (AstrBot)

Este servidor MCP

Las herramientas devuelven texto en chino, el LLM organiza la respuesta

Devuelve JSON estructurado, el llamador organiza la respuesta

Permisos de grupo QQ (admin_ids / admin_role)

Interruptor de lectura/escritura MCSM_ALLOW_WRITE (solo lectura por defecto), el cliente llamador se encarga del control de acceso

Sondeo en segundo plano + notificaciones push activas tras iniciar/detener

mcs_wait_for_status es sondeado por el LLM según necesidad para confirmar

Comandos de activación como mc列表

Se delega al cliente/LLM el uso directo de las herramientas (sin contexto de chat)

Inyección forzada de hooks de herramientas de agente/aviso de sistema

Las herramientas MCP se exponen de forma natural según las necesite el cliente, sin inyección

Inicio rápido

cd servers/mcs-manager
python -m venv .venv                 # 或 uv venv .venv
.venv/Scripts/pip install -e .        # 或 uv pip install -p .venv -e .

Configuración (copia .env.example como .env y rellénalo, o usa directamente variables de entorno):

MCSM_BASE_URL=http://127.0.0.1:23333   # 面板地址
MCSM_API_KEY=xxxx                      # v10 API Key（推荐）；或 MCSM_USERNAME + MCSM_PASSWORD
MCSM_ALLOW_WRITE=1                     # 写操作开关：0=只读（默认），1=允许启动/停止等

Cómo modificar la configuración (configuración del plugin → configuración MCP)

El plugin original de AstrBot se configuraba en el panel de administración; tras la conversión a MCP, la configuración pasa a ser el archivo servers/mcs-manager/.env (o variables de entorno). La correspondencia con los elementos de configuración del plugin original se muestra en la siguiente tabla; los valores por defecto son idénticos:

Elemento de configuración del plugin original

Variable de entorno MCP

Descripción

mcs_base_url

MCSM_BASE_URL

Dirección del panel

mcs_api_key

MCSM_API_KEY

API Key v10 (recomendado)

mcs_username / mcs_password

MCSM_USERNAME / MCSM_PASSWORD

Inicio de sesión con cuenta/contraseña (v9)

mcs_api_timeout

MCSM_TIMEOUT

Tiempo de espera de solicitud (segundos)

mcs_permission_enabled + mcs_admin_ids/mcs_admin_role

MCSM_ALLOW_WRITE

Permisos de grupo QQ → interruptor general de lectura/escritura (solo lectura por defecto)

mcs_command_whitelist

MCSM_COMMAND_WHITELIST

Lista blanca de comandos (separados por comas)

mcs_blocked_commands

MCSM_BLOCKED_COMMANDS

Lista negra de comandos

mcs_operation_wait

MCSM_OPERATION_WAIT

Segundos de espera por defecto de la herramienta wait

mcs_enabled

— (se activa al iniciar el proceso)

Ya no se necesita interruptor general; si no se inicia el proceso, queda desactivado

mcs_force_agent_tool

— (sin sentido)

Las herramientas MCP se exponen según las necesite el cliente, sin inyección forzada

Pasos para modificar:

  1. Edita servers/mcs-manager/.env (si no existe, primero cp .env.example .env);

  2. Llama a la herramienta mcs_reload_config para aplicar en caliente, o reinicia directamente el proceso del servidor;

  3. Verifica los valores activos con mcs_get_config (las credenciales se muestran enmascaradas como ***).

Si pasas variables de entorno a través de la configuración del cliente (como el bloque env en la configuración de Claude Desktop), tras editarlas también puedes llamar a mcs_reload_config o reiniciar para que surtan efecto.

Ejecución

stdio (proceso local, recomendado):

.venv/Scripts/python -m mcsm_mcp
# 或已安装的入口命令：mcsm-mcp

HTTP (remoto/múltiples clientes):

.venv/Scripts/python -m mcsm_mcp --transport http --host 127.0.0.1 --port 8000
# 端点：http://127.0.0.1:8000/mcp （streamable-http）

Ejemplo de integración de cliente (stdio)

claude_desktop_config.json de Claude Desktop:

{
  "mcpServers": {
    "mcs-manager": {
      "command": "<安装路径>/.venv/Scripts/python.exe",  // Windows；Linux/macOS 用 <安装路径>/.venv/bin/python
      "args": ["-m", "mcsm_mcp"],
      "env": {
        "MCSM_BASE_URL": "http://127.0.0.1:23333",
        "MCSM_API_KEY": "你的面板 API Key",
        "MCSM_ALLOW_WRITE": "1"
      }
    }
  }
}

Depuración: selecciona stdio en npx @modelcontextprotocol/inspector y rellena los command/args indicados.

Variables de entorno completas

Variable

Descripción

Valor por defecto

MCSM_BASE_URL

Dirección del panel (sin barra final)

http://127.0.0.1:23333

MCSM_API_KEY

API Key del panel (v10 recomendado)

vacío

MCSM_USERNAME / MCSM_PASSWORD

Inicio de sesión con cuenta/contraseña (v9 o sin Key configurada)

vacío

MCSM_TIMEOUT

Tiempo de espera de solicitud al panel (segundos)

15

MCSM_ALLOW_WRITE

Interruptor de operaciones de escritura

0 (solo lectura)

MCSM_COMMAND_WHITELIST

Lista blanca de comandos de consola (prefijos separados por comas; vacío = permitir todos)

vacío

MCSM_BLOCKED_COMMANDS

Lista negra de comandos peligrosos (coincidencia por primera palabra)

stop,restart

MCSM_OPERATION_WAIT

Límite de espera por defecto de mcs_wait_for_status (segundos)

600

MCSM_TRANSPORT

stdio o http

stdio

MCSM_HOST / MCSM_PORT

Dirección/puerto de escucha http

127.0.0.1 / 8000

MCSM_ENV_FILE

Ruta del archivo .env especificado (opcional)

.env

Pruebas

.venv/Scripts/python tests/test_smoke.py   # stdio：tools/list + 无凭据/只读拦截/连接错误
.venv/Scripts/python tests/test_http.py    # streamable-http 握手与调用

Aviso de seguridad

  • Solo lectura por defecto: iniciar/detener/reiniciar/detener forzosamente/enviar comandos requieren MCSM_ALLOW_WRITE=1; actívalo únicamente cuando se conecten clientes de confianza.

  • La lista negra de comandos bloquea por defecto stop/restart, para evitar eludir las operaciones del panel mediante comandos de consola; también puedes configurar una lista blanca para restringir aún más.

  • Las credenciales del panel se almacenan en .env (ignorado por .gitignore) o en variables de entorno; no las subas al repositorio.

  • Que una herramienta de escritura devuelva submitted=true solo significa que el comando se ha enviado (asíncrono en segundo plano); para confirmar la finalización usa mcs_wait_for_status.

Estructura del código fuente

src/mcsm_mcp/
├── __main__.py   # python -m mcsm_mcp 入口
├── server.py     # MCPServer + 8 个工具（mcp SDK 2.x）
├── api.py        # MCSManagerAPI 客户端（无 AstrBot 依赖，含 v9/v10 兼容）
└── config.py     # 环境变量配置 + 读写开关 + 指令白/黑名单策略
Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

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