MCppServer
Fast and super efficient Minecraft Server written in C++
claude mcp add --transport stdio noeli14-mcppserver ./MCppServer \ --env PLACEHOLDER="site-specific or leave empty"
How to use
MCppServer is a fast, high-performance Minecraft server written in C++. It aims to be compatible with Java clients while focusing on speed, efficient chunk loading, and extensive customization. Once you have built the server binary, you can start it to accept Minecraft connections, use the built-in server features such as authentication, encryption, packet compression, query support, and RCON for remote administration. The server also provides configuration options for server links, registries, resource packs, translations, and more. You can connect a Minecraft client to the server using the default port (usually 25565) after configuring any necessary firewall or network settings. If you plan to run pre-generated worlds, simply place the world folder in the server directory and start the binary to load it on startup.
How to install
Prerequisites:
- A modern C++20 capable compiler (GCC or Clang) and CMake 3.14 or higher
- Git to clone the repository
- Optional: MINGW on Windows for builds without POSIX compatibility
Installation steps:
-
Clone the repository git clone https://github.com/Noeli14/MCppServer.git cd MCppServer
-
Create a build directory and configure the project mkdir build cd build cmake ..
// For Debug builds cmake -DCMAKE_BUILD_TYPE=Debug ..
// For Release builds cmake -DCMAKE_BUILD_TYPE=Release ..
-
Build the server
- Linux/macOS: make
- Windows (MinGW with Makefiles): cmake .. -G "Unix Makefiles" make
- Windows (MinGW with Ninja): cmake .. -G "Ninja" ninja
-
Run the server ./MCppServer
Notes:
- The server is actively developed; expect ongoing improvements and possible bugs in early versions.
- If you plan to run on Linux, you may want to disable online mode in config.json for testing locally as noted in the project documentation.
You can now connect a Minecraft client to the server using its IP and port, and configure additional features via the provided configuration files in the server directory.
Additional notes
Tips and considerations:
- The project centers on high-performance, multi-threaded design with efficient chunk loading and a modular architecture. Performance tuning often involves adjusting CMake build types and compiler flags.
- Configuration is handled through JSON/config files such as server links, registries, and resource packs. Review config.json and related files after first run.
- If you need plugins later, note that plugin support is listed as coming soon in the roadmap; you can keep an eye on discussions for updates.
- For Linux users, ensure required permissions and network settings allow inbound connections on the Minecraft port. If you encounter startup issues, check build logs and enabled features in the config.
- The server relies on PrismarineJS data as a data source for game mechanics; keep an eye on compatibility with new Minecraft versions as updates are released.
Related MCP Servers
xiaozhi-esp32
An MCP-based chatbot | 一个基于MCP的聊天机器人
unreal
Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
deeppowers
DEEPPOWERS is a Fully Homomorphic Encryption (FHE) framework built for MCP (Model Context Protocol), aiming to provide end-to-end privacy protection and high-efficiency computation for the upstream and downstream ecosystem of the MCP protocol.
cpp
Lightweight C++ MCP (Model Context Protocol) SDK
x64dbgMCP
Model Context Protocol for x64dbg & x32dbg
mcp-cpp
A C++ SDK for the Model Context Protocol (MCP). The SDK will provide a framework for creating MCP servers and clients in C++.