Skip to main content
Glama
chaofanx
by chaofanx

MCSManager MCP Server

这是一个用于管理 Minecraft 服务器的 MCP (Model Context Protocol) 服务器,支持通过 npm 安装和 npx 直接执行。

功能特性

  • 执行 Minecraft 服务器命令

  • 获取在线玩家列表

  • 获取服务器状态信息

  • 设置服务器天气

  • 通过命令行参数安全配置敏感信息

安装和使用

全局安装(推荐)

npm install -g mcsmanager-mcp

使用 npx(无需安装)

npx mcsmanager-mcp --base-url <url> --api-key <key> --uuid <uuid> --daemon-id <id>

本地开发

# 安装依赖
pnpm install

# 开发模式
pnpm run dev -- --base-url <url> --api-key <key> --uuid <uuid> --daemon-id <id>

# 构建
pnpm run build

# 运行构建后的版本
pnpm start -- --base-url <url> --api-key <key> --uuid <uuid> --daemon-id <id>

配置

命令行参数

所有敏感信息都通过命令行参数提供,确保安全性:

mcsmanager-mcp --base-url <url> --api-key <key> --uuid <uuid> --daemon-id <id>

必需参数:

  • --base-url <url>: MCSManager API 基础URL

  • --api-key <key>: API密钥

  • --uuid <uuid>: UUID

  • --daemon-id <id>: Daemon ID

可选参数:

  • --help, -h: 显示帮助信息

示例

# 使用 npx 运行
npx mcsmanager-mcp \
  --base-url http://localhost:23333 \
  --api-key your-api-key \
  --uuid your-uuid \
  --daemon-id your-daemon-id

# 全局安装后运行
mcsmanager-mcp \
  --base-url http://your-server:23333 \
  --api-key your-api-key \
  --uuid your-uuid \
  --daemon-id your-daemon-id

可用工具

execute_command

执行 Minecraft 服务器命令

参数:

  • cmd (string): 要执行的命令

示例:

{
  "cmd": "/say Hello World"
}

get_players

获取当前在线玩家列表

参数:

get_server_status

获取服务器状态信息

参数:

返回:

{
  "online_players": 2,
  "player_names": ["player1", "player2"],
  "status": "online"
}

set_weather

设置服务器天气

参数:

  • weather (string): 天气类型,可选值: "clear", "rain", "thunder"

示例:

{
  "weather": "rain"
}

发布到 npm

发布前准备

  1. 确保你已经登录到 npm:

npm login
  1. 更新版本号(如果需要):

npm version patch  # 或 minor, major
  1. 构建项目:

pnpm run build

发布

npm publish

发布到测试环境(可选)

npm publish --tag beta

许可证

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Resources

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

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/chaofanx/mcsmanager-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server