MCSS MCP Server

What is MCSS MCP Server?

A Model Context Protocol (MCP) server for controlling Minecraft servers via the MCSS (Minecraft Server Software) API. It enables seamless interaction with your Minecraft servers using MCP clients like Claude Desktop.

How to use MCSS MCP Server?

Clone the repository, install dependencies (mcp[cli], httpx, python-dotenv), create a .env file with your MCSS host, port, and API key, then configure Claude Desktop to run the server. Once launched, tools are available directly in Claude Desktop.

Key features of MCSS MCP Server

• List and get details of Minecraft servers managed by MCSS
• Execute power actions (start, stop, restart, kill)
• Run and schedule Minecraft commands
• View real-time server console output
• Manage backup configurations and run backups
• Create, update, delete, and run scheduled tasks

Use cases of MCSS MCP Server

• Monitor and control multiple Minecraft servers from a single MCP client
• Automate server restarts and crash handling
• Execute in-game commands without direct console access
• Schedule backups and maintenance tasks

FAQ from MCSS MCP Server

What is MCSS?

MCSS (Minecraft Server Software) is the system the server connects to. It must have the Web API enabled, and you need an API key to use this MCP server.

What are the runtime dependencies?

Python 3.10 or higher is required, along with the mcp[cli], httpx, and python-dotenv packages.

How do I configure the server?

Create a .env file with three variables: MCSS_HOST (the IP of your MCSS instance), MCSS_PORT (default 25560), and MCSS_API_KEY. Then update your Claude Desktop configuration to point to the server's batch file.

What actions can I perform on a server?

You can list servers, get server details, edit server settings, start/stop/restart/kill servers, execute console commands, view the console log, manage backups, and schedule tasks.

What transport does the server use?

The server uses the standard MCP transport over stdio, as it runs as a subprocess of Claude Desktop (or any MCP client). No separate network transport is mentioned.