Get the FREE Ultimate OpenClaw Setup Guide →

MCppServer

Fast and super efficient Minecraft Server written in C++

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
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:

  1. Clone the repository git clone https://github.com/Noeli14/MCppServer.git cd MCppServer

  2. 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 ..

  3. Build the server

    • Linux/macOS: make
    • Windows (MinGW with Makefiles): cmake .. -G "Unix Makefiles" make
    • Windows (MinGW with Ninja): cmake .. -G "Ninja" ninja
  4. 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

Sponsor this space

Reach thousands of developers