Home

minecraft-mcp

minecraft-mcp connects an AI client, such as Claude, to your Minecraft server. It runs next to the client, talks to the WorldAPI plugin on a Paper server, and gives the agent tools to look at the world and, if your token allows, to change it. This wiki walks you through it one step at a time.

For players and server owners

1. Installation: what you need before you start.
2. Connect your client: Claude Desktop, Claude Code, Cursor, or Other clients (VS Code, any stdio client, HTTP).
3. Configuration: environment variables and command-line flags.
4. Tokens and permissions: which WorldAPI token fits which job.
5. Tools: every tool, what it does, and the permission it needs.
6. Example prompts: what to ask and how the agent answers.
7. Security: what keeps a live server safe.
8. Troubleshooting: when something doesn't work.

For developers

• Building from source
• Architecture
• Development
• Releasing