World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Control a Minecraft client with the Minecraft MCP mod and JsMacros Reloaded.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 16/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 28/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 8 (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Minecraft MCP. Sigue https://mcp.popnx.com/i/makkch-minecraft-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 18 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Minecraft MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Minecraft MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "minecraft": { "command": "npx", "args": [ "-y", "@makkch/minecraft-mcp" ], "env": { "MINECRAFT_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MINECRAFT_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Minecraft MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Minecraft MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Minecraft MCP o muestra una herramienta de Minecraft MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_MCP_URL Dirección HTTP(S) del mod MCP de Minecraft. Admite un prefijo de ruta de proxy. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Minecraft MCP
Minecraft MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Minecraft MCP
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Minecraft MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Minecraft MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user minecraft --env MINECRAFT_MCP_TOKEN=your-value -- npx -y @makkch/minecraft-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MINECRAFT_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Minecraft MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user minecraft --env MINECRAFT_MCP_TOKEN=your-value -- npx -y @makkch/minecraft-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Minecraft MCP en la lista como conectado
Usa Minecraft MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Minecraft MCP o muestra una herramienta de Minecraft MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_MCP_URL Dirección HTTP(S) del mod MCP de Minecraft. Admite un prefijo de ruta de proxy. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Minecraft MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Minecraft MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "minecraft": { "command": "npx", "args": [ "-y", "@makkch/minecraft-mcp" ], "env": { "MINECRAFT_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MINECRAFT_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Minecraft MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Minecraft MCP, MINECRAFT_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Minecraft MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Minecraft MCP o muestra una herramienta de Minecraft MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_MCP_URL Dirección HTTP(S) del mod MCP de Minecraft. Admite un prefijo de ruta de proxy. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Minecraft MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Minecraft MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "minecraft": { "type": "stdio", "command": "npx", "args": [ "-y", "@makkch/minecraft-mcp" ], "env": { "MINECRAFT_MCP_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MINECRAFT_MCP_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Minecraft MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Minecraft MCP, MINECRAFT_MCP_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Minecraft MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Minecraft MCP o muestra una herramienta de Minecraft MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_MCP_URL Dirección HTTP(S) del mod MCP de Minecraft. Admite un prefijo de ruta de proxy. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user minecraft --env MINECRAFT_MCP_TOKEN=your-value -- npx -y @makkch/minecraft-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"minecraft": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "your-value"
}
}
}
}MINECRAFT_MCP_TOKEN secreto obligatorio envMINECRAFT_MCP_URL envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub MakkCH, dueña del repo
Último cambio de código: anteayer
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Aún no revisado
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/makkch-minecraft-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MINECRAFT_MCP_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (0.5.0) llegó al registro anteayer.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| Este Minecraft MCP | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Minecraft MCP Let an AI agent play in your Minecraft client. Stop its scripts with /mcp stop .
English · 繁體中文
Gallery · Requirements · Installation · Staying in control · Remote connection
The agent controls your character with JsMacros scripts: it writes one, runs it, reads the output, takes a screenshot, and reports in chat. You watch from your own point of view and type /mcp stop to disable the agent.
Everything here was done by an agent through Minecraft MCP. Browse all projects.
From an empty inventory to the End Poem A Codex agent ( gpt-6-astra , high reasoning effort) started with nothing, gathered resources, reached the End and defeated the Ender Dragon. It wrote and revised its own JavaScript along the way: mining, trading, recovering gear after deaths, building safer routes, and finally setting off beds from behind a wall. Java 26.3, Normal difficulty, about 8 hours 25 minutes. Full run and retrospective
F36: a compact 6× shulker box loader A 3×3×4 single-item shulker box loader designed by GPT-6 Astra. Modules with minecarts tile every three blocks at the same height; a single module runs without one. Schematics exported from Java 26.3. Watch the video · Download the schematics
The banner scene was built and captured in Minecraft by GPT-6 Astra using Minecraft MCP.
Fabric only for now. Forge, NeoForge and other Minecraft versions are not supported yet.
| Minecraft Java Edition | Download this JAR group | Baritone API Fabric (optional) |
|---|---|---|
| 26.1, 26.1.1, 26.1.2 | 26.1 | 1.18.0 |
| 26.2 | 26.2 | 1.19.0 |
| 26.3 | 26.3 | 1.20.0 |
| Component | Requirement |
|---|---|
| Fabric Loader | 0.19.5 or later |
| Java | 25 or later |
| JsMacros Reloaded | 2.2.1, same JAR group as above (bundles the Fabric API modules this mod needs) |
| Node.js | 22+ for the MCP server; 22.20+ for Skills CLI |
| Agent | Codex, Claude Code, Claude Desktop, Cursor, or any client with stdio MCP support |
| Baritone | Optional, strongly recommended |
Without Baritone, scripts, screenshots and direct player control still work, but the agent has to script its own pathfinding and resource gathering.
There are three things to install:
| Where | What it does | |
|---|---|---|
| Mod | Minecraft | Receives commands and runs them in the game |
| Skill | Agent | Teaches the agent how to write scripts and which APIs exist |
| MCP server | Agent | Exposes the game as tools the agent can call |
We recommend running the agent, MCP server and Minecraft on the same computer.
-sources.jar).mods/ folder together with JsMacros and, preferably, Baritone.28473). You need both in step 3./mcp config opens the same screen. So does Mods → Minecraft MCP → Configure if you have Mod Menu. F8 can be rebound in Minecraft's Controls settings.
The screen also has: Allow remote (off by default), automatic startup, and the [AGENT] chat tag, name and colors.
Where is my mods/ folder?
| Launcher | Location |
|---|---|
| Official Minecraft Launcher | mods/ inside the installation's Game Directory. By default .minecraft/mods/ on Windows/Linux, ~/Library/Application Support/minecraft/mods/ on macOS |
| Prism Launcher, MultiMC | Open the instance's Minecraft folder; usually .minecraft/mods/ inside the instance folder |
| Other launchers | Open the instance's game folder and use its mods/ |
npx skills add MakkCH/minecraft_mcp --skill minecraft-mcp -g
Pick your agent when prompted, or name it directly with -a codex, -a claude-code or -a cursor. -g installs for your user so every project can use it; leave it out to install for the current project only.
If your client has no Skill support, give the agent SKILL.md as instructions and make sure it can read the files that document refers to.
Add a stdio MCP server in your agent client, using the token from step 1 and the game's URL. The URL defaults to http://127.0.0.1:28473/; if F8 shows a different port, change the port in the URL.
Codex
Add this to ~/.codex/config.toml. If a minecraft_mcp entry already exists, edit it instead of adding a second one. (Codex MCP documentation)
[mcp_servers.minecraft_mcp]
command = "npx" args = ["-y", "@makkch/minecraft-mcp@latest"]
[mcp_servers.minecraft_mcp.env] MINECRAFT_MCP_TOKEN = "YOUR_TOKEN" MINECRAFT_MCP_URL = "http://127.0.0.1:28473/"
Claude Code
claude mcp add --env MINECRAFT_MCP_TOKEN=YOUR_TOKEN \
--env MINECRAFT_MCP_URL=http://127.0.0.1:28473/ --transport stdio --scope user minecraft_mcp \ -- npx -y @makkch/minecraft-mcp@latest
Cursor / Claude Desktop
For Cursor, add this to ~/.cursor/mcp.json or your project's .cursor/mcp.json. For Claude Desktop, add it to claude_desktop_config.json. (Cursor documentation · Claude Desktop guide)
{
"mcpServers": { "minecraft_mcp": { "command": "npx", "args": ["-y", "@makkch/minecraft-mcp@latest"], "env": { "MINECRAFT_MCP_TOKEN": "YOUR_TOKEN", "MINECRAFT_MCP_URL": "http://127.0.0.1:28473/" } } } }
Other clients (setup form)
| Field | Value |
|---|---|
| Name | minecraft_mcp |
| Transport | stdio |
| Command | npx |
| Arguments | -y and @makkch/minecraft-mcp@latest (two separate arguments) |
| Environment | MINECRAFT_MCP_TOKEN, MINECRAFT_MCP_URL |
Good to know:
npx -y @makkch/minecraft-mcp@latest is meant to be run by your MCP client. Run it yourself in a terminal and you only get a process waiting for input.@latest selects the version tagged latest on npm. To pin a version, replace it with a version number that is compatible with your mod.Restart your client's MCP connection, start a new chat, and say:
Inspect my Minecraft client and tell me what you can see.
Gather some wood nearby and keep me updated in chat.
If nothing happens, see Connection help.
Other ways to install: release archive, Codex plugin
Archive (`.tgz`): download it from the release and extract it. In your MCP configuration, set the command to node and the argument to the absolute path of src/server.mjs; the environment variables stay the same. Install the Skill as in step 2.
Codex plugin: still available and includes the Skill, but not recommended for new installations. Use the standalone setup above to configure the token and URL for each game instance (Codex MCP settings). See Codex plugin installation.
If you already use the plugin and want to switch to the standalone setup above, disable the plugin before enabling the standalone MCP server and Skill.
| In Minecraft | Effect |
|---|---|
/mcp stop | Disable the agent, stop MCP tasks, run their registered cleanup and release pressed keys |
/mcp start | Allow the agent to act again |
/mcp status | Show whether control is enabled and how many tasks are running |
/mcp config or F8 | Open the settings screen |
[AGENT] messages appear only in your own chat. They are not sent to multiplayer servers.The mod adds no blocks, items or entities, so removing it needs no changes to your save. What the agent does is as real as what you do: it changes your world and inventory.
Optional: connect to a game on another computer
Script contents can be sent to another computer, but require() and other file access use the game computer's filesystem. Use self-contained scripts or prepare dependencies on the game computer yourself.
MINECRAFT_MCP_URL to the game's address, such as http://192.168.1.20:28473/.Alternatively, leave Allow remote off and use an SSH tunnel:
ssh -N -L 38473:127.0.0.1:28473 user@game-host
Set the URL to http://127.0.0.1:38473/. MINECRAFT_MCP_URL also accepts HTTPS, IPv6, custom ports and proxy path prefixes.
Scripts run with the full permissions of the Minecraft process. Connect only trusted agents; use SSH or HTTPS across untrusted networks to protect the token and script contents. Custom addresses and Allow remote require 0.4.0 or later.
| Symptom | What to do |
|---|---|
| Connection refused | Check that you launched the instance with the mod, and compare the port with F8 |
| Authentication failed / HTTP 401 | The token does not match F8. Fix it and restart the MCP connection |
| Agent control disabled | Type `/mcp start