minestom-mcp

A stdio MCP server for Minestom, implemented with the Model Context Protocol SDK and TanStack AI tool definitions.

Preferred package invocation:

npx -y minestom-mcp

Often a file like .mcp.json at your project root will be picked up by agents:

{
  "mcpServers": {
    "minestom-mcp": {
      "command": "npx",
      "args": ["-y", "minestom-mcp"]
    }
  }
}

Installed command aliases:

minestom-mcp-server
minestom-mcp

Why this shape:

• minestom-mcp-server is the npm package name and the safest npx entrypoint.
• minestom-mcp is the shorter command alias after install.
• npm npx resolves the matching bin when one of the bin entries matches the package name, so publishing the package as minestom-mcp-server with a minestom-mcp-server bin keeps npx -y minestom-mcp-server reliable. Source: npm npx docs

The tool surface is grounded in:

• the official Minestom docs at minestom.net/docs
• the Minestom javadocs at javadoc.minestom.net
• the Minestom ecosystem directory at minestom.net/libraries

Detailed tool documentation lives in docs/tools.md.

The repository also ships a publish-ready static docs site in `docs/` plus a GitHub Pages workflow in `/.github/workflows/deploy-docs.yml`.

Community and contribution docs live in CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.

• ping: verifies that the MCP server is reachable.
• get_server_info: returns package metadata, runtime details, tool inventory, and knowledge-catalog coverage.
• inspect_minestom_environment: inspects the current workspace or repoRoot, including subdir