MCSManager

MCSManager MCP Server

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chaofanx-mcsmanager-mcp": {
      "command": "npx",
      "args": [
        "mcsmanager-mcp",
        "--base-url",
        "<url>",
        "--api-key",
        "<key>",
        "--uuid",
        "<uuid>",
        "--daemon-id",
        "<id>"
      ]
    }
  }
}

You run an MCP server that lets you manage a Minecraft server from a secure, command-driven interface. It supports executing server commands, listing online players, checking status, and adjusting weather, all through a simple MCP client/server workflow.

How to use

Connect to your MCP server using the MCP client tooling. You can run the server locally via npx or install it globally, then issue commands to control the Minecraft server, query player lists, check status, and set weather. All sensitive configuration is provided through command-line arguments to keep your setup secure.

How to install

Prerequisites: Node.js and npm or pnpm installed on your machine.

Option 1: Install globally (recommended)

npm install -g mcsmanager-mcp

Option 2: Use npx without installing

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

Configuration and usage notes

All sensitive information is supplied via command-line arguments to keep configuration secure.

Common options you will provide:

--base-url <url> the MCP API base URL
--api-key <key> your API key
--uuid <uuid> your UUID

--daemon-id <id> daemon identifier

Operations you can perform

Execute Minecraft server commands, fetch the list of online players, retrieve server status, and set the weather. These capabilities are exposed as MCP commands you can call from your MCP client.

For example, you can execute commands like yelling a message, request player lists, inspect status, or switch the weather type.

Examples

Run via npx with your credentials and identifiers.

npx mcsmanager-mcp \
  --base-url http://localhost:23333 \
  --api-key your-api-key \
  --uuid your-uuid \
  --daemon-id your-daemon-id

Available tools

execute_command

Executes a command on the Minecraft server and returns the output.

get_players

Fetches the list of currently online players.

get_server_status

Retrieves server status information including online players and overall state.

set_weather

Sets the in-game weather to a specified type (clear, rain, thunder).