com.mairwunnx/minecraft-mcp

@mairwunnx/minecraft-mcp

Ask an AI about your Minecraft server and let it run it: players, worlds, configs, logs.

193/wk GitHub npm

No known CVEs

MIT license

Actively maintained

Last commit 3d ago

Works with most clients

Transport: stdio, http

0 tools

Grade F

MCPpedia last refreshed this data 2d ago

Edit this pageView history

com.mairwunnx/minecraft-mcp is an MCP server that ask an AI about your Minecraft server and let it run it: players, worlds, configs, logs. Its tool list has not been published yet over stdio and http, requires no API key, and scores 62/100 on MCPpedia's security, maintenance and efficiency rubric.

Entertainment

Step 1

Install in your client

Config is the same across clients - only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "minecraft": {
      "env": {
        "WORLDAPI_URL": "http://localhost:8110/api/v1",
        "WORLDAPI_TOKEN": "your-token"
      },
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/com-mairwunnx-minecraft-mcp)](https://mcppedia.org/s/com-mairwunnx-minecraft-mcp)

Read me

What com.mairwunnx/minecraft-mcp does

Ask an AI about your Minecraft server and let it run it: players, worlds, configs, logs.

Test This Server

This server supports HTTP transport. Be the first to test it - help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories - click any category to see the underlying evidence.

Score breakdown

62/100across 5 weighted dimensions

How we score →

0255075100

−38

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @mairwunnx/minecraft-mcp against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience - it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is com.mairwunnx/minecraft-mcp safe to use?: com.mairwunnx/minecraft-mcp has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.
How do I install com.mairwunnx/minecraft-mcp?: com.mairwunnx/minecraft-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with com.mairwunnx/minecraft-mcp?: com.mairwunnx/minecraft-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is com.mairwunnx/minecraft-mcp actively maintained?: com.mairwunnx/minecraft-mcp is actively maintained - last commit was 3 days ago.

Similar servers

Others in entertainment

View all →

com.mux/mcp95

The official MCP Server for the Mux API

182 7

Claude Video Vision93

Give Claude the ability to watch and understand videos — Claude Code plugin with frame extraction and multimodal audio analysis

1.5k 4

Unity MCP90

Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.

Arr MCP Server90

MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr

241 20

MCP Security Weekly

Get CVE alerts and security updates for com.mairwunnx/minecraft-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "minecraft": { "env": { "WORLDAPI_URL": "http://localhost:8110/api/v1", "WORLDAPI_TOKEN": "your-token" }, "args": [ "-y", "@mairwunnx/minecraft-mcp" ], "command": "npx" } } }

minecraft-mcp

🤖 minecraft-mcp lets an AI agent see and run your Minecraft server. Ask Claude “who’s online and where are they?”, “why is the server lagging?”, or “give everyone bread and set the time to morning”, and it answers with real data from your world.

It runs next to your AI client: Claude Desktop, Claude Code, Cursor, VS Code, or anything else that speaks MCP. From there it talks to WorldAPI on a Paper, Fabric, or NeoForge server, or in the world you play alone. The token you give it decides what the agent may do.

What you get

🧰 51 tools for the server, worlds, blocks, chests, entities, players, commands, leaderboards, recipes, configs, logs, and Java scripts. Most take several targets at once, so the agent makes fewer calls.

🎒 Inventories in depth: every item’s enchantments, durability, and potion effects, and what’s inside shulker boxes and bundles.

📜 Configs and logs: the agent reads the console and any config, and with the right token changes a value and keeps its comments.

🔑 Only what your token allows: a viewer token shows 19 tools that only look, and read-only mode hides every write.

🎮 Singleplayer, no setup: with the WorldAPI mod in your game, minecraft-mcp finds the open world by itself and follows you from world to world. Ask “what am I looking at?” while you play.

🙋 “Me” means you: set your player name, and “where am I?” just works.

⏳ Live events: “tell me when Steve joins”.

📣 Discord and Telegram in one sentence: “send deaths to my Discord” or “post joins to Telegram in Russian”, and the agent connects them through WorldAPI’s webhooks. Slack, Teams, and Google Chat too.

↩️ Undo: the agent reads a build before it changes it, and takes back what it placed if you don’t like it.

🧭 Never stuck on setup: when the address, the token, or WorldAPI itself is missing, the agent says what’s wrong and how to fix it, in game or in the admin panel.

🛡️ Safe by design: game text is fenced as data, tools say when they destroy something, and the token never leaks.

🔌 Every client: Claude Desktop in one click, or any MCP client over stdio or HTTP.

Get started

Install WorldAPI 4.2.0 or newer on your Paper, Fabric, or NeoForge server, and make a token with /worldapi token create agent. Playing alone? Put the WorldAPI mod in your game and skip the address and the token: claude mcp add minecraft -- npx -y @mairwunnx/minecraft-mcp. The Singleplayer page has the rest.

Add minecraft-mcp to your client. In Claude Desktop, open minecraft-mcp.mcpb. In Claude Code:

claude mcp add minecraft -e WORLDAPI_URL=http://localhost:8110/api/v1 -e WORLDAPI_TOKEN=your-token -- npx -y @mairwunnx/minecraft-mcp

Ask “what’s the server status?”. The Installation page covers Cursor, VS Code, and HTTP.

Frequently Asked Questions

Is com.mairwunnx/minecraft-mcp safe to use?

com.mairwunnx/minecraft-mcp has no known CVEs as of the latest MCPpedia security scan. Authentication requirements were not detected automatically - check the project's documentation before connecting in a shared environment. Licensed under MIT.

How do I install com.mairwunnx/minecraft-mcp?

com.mairwunnx/minecraft-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What AI clients work with com.mairwunnx/minecraft-mcp?

com.mairwunnx/minecraft-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is com.mairwunnx/minecraft-mcp actively maintained?

com.mairwunnx/minecraft-mcp is actively maintained - last commit was 3 days ago.

minecraft-mcp

What you get

🎒 Inventories in depth: every item’s enchantments, durability, and potion effects, and what’s inside shulker boxes and bundles.

📜 Configs and logs: the agent reads the console and any config, and with the right token changes a value and keeps its comments.

🔑 Only what your token allows: a viewer token shows 19 tools that only look, and read-only mode hides every write.

🎮 Singleplayer, no setup: with the WorldAPI mod in your game, minecraft-mcp finds the open world by itself and follows you from world to world. Ask “what am I looking at?” while you play.

🙋 “Me” means you: set your player name, and “where am I?” just works.

⏳ Live events: “tell me when Steve joins”.

↩️ Undo: the agent reads a build before it changes it, and takes back what it placed if you don’t like it.

🧭 Never stuck on setup: when the address, the token, or WorldAPI itself is missing, the agent says what’s wrong and how to fix it, in game or in the admin panel.

🛡️ Safe by design: game text is fenced as data, tools say when they destroy something, and the token never leaks.

🔌 Every client: Claude Desktop in one click, or any MCP client over stdio or HTTP.

Get started

Add minecraft-mcp to your client. In Claude Desktop, open minecraft-mcp.mcpb. In Claude Code:

claude mcp add minecraft -e WORLDAPI_URL=http://localhost:8110/api/v1 -e WORLDAPI_TOKEN=your-token -- npx -y @mairwunnx/minecraft-mcp

Ask “what’s the server status?”. The Installation page covers Cursor, VS Code, and HTTP.

com.mairwunnx/minecraft-mcp

Install in your client

What com.mairwunnx/minecraft-mcp does

Test This Server

Why this score

62/100across 5 weighted dimensions

Security

Reviews

Frequently Asked Questions

Similar servers

Discussion

com.mairwunnx/minecraft-mcp

Install in your client

What com.mairwunnx/minecraft-mcp does

Test This Server

minecraft-mcp

What you get

Get started

Try it live

Why this score

62/100across 5 weighted dimensions

Security

Reviews

Frequently Asked Questions

Similar servers

Discussion

minecraft-mcp

What you get

Get started

Try it live