mcpt

Minecraft Portugal server setup

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio minecraftportugal-mcpt-server docker run -i minecraftportugal/mcpt:latest \
  --env MCPT_PORT="Port to expose for Minecraft (default 25565)" \
  --env MCPT_WORLD="World/realm to load on startup (optional)"

How to use

MCPT is a Minecraft server provided by the Minecraft Portugal project. This MCP server is intended to run as a Docker container that hosts a Minecraft game instance for players in Portugal and nearby regions, offering a dedicated game server with the MCPT configuration baked in. After starting the container, players can connect to the server using your host's IP address and the exposed Minecraft port (default 25565). The server image includes sensible defaults and environment variables to customize the port and the world loaded on startup. Use the MCP tooling to monitor status, logs, and basic configuration snippets as needed.

Once running, you can interact with the server through standard Minecraft client connections. If you need to adjust settings, modify environment variables at startup (for example, MCPT_PORT or MCPT_WORLD) and restart the container. The MCP interface will reflect status updates and provide access to logs to help diagnose startup issues or connection problems.

How to install

Prerequisites:

Docker (desktop or daemon) installed and running
Sufficient CPU/RAM for a Minecraft server (1GB+ RAM recommended for light usage)

Installation steps:

Pull the MCPT Docker image (or ensure it is available in your registry): docker pull minecraftportugal/mcpt:latest
Run the MCP server container with optional customization: docker run -d --name mcpt
-p 25565:25565
-e MCPT_PORT=25565
-e MCPT_WORLD=default-world
minecraftportugal/mcpt:latest
Verify the container is running and listening on the Minecraft port: docker ps nc -zv localhost 25565
Connect with a Minecraft client using your host IP and port 25565. To stop the server: docker stop mcpt docker rm mcpt

Additional notes

Tips:

If you change MCPT_PORT, ensure the host firewall allows traffic on the new port and re-map the port in Docker (docker run -p hostPort:containerPort).
The MCPT_WORLD environment variable lets you choose which world to load on startup; if omitted, a default world will be created.
Check logs for troubleshooting: docker logs mcpt
If you’re deploying behind NAT or a firewall, ensure port forwarding is configured correctly for the Minecraft port.
Regularly back up your world data volume if persistent storage is used by the image.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.