mcp server

mcsrc-mcp

mnooseman/mcsrc-mcpcommunitylistedunreviewed

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

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

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

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 22, 2026

MC Source MCP Server

An MCP server that allows you to explore and decompile Minecraft source code, specifically targeting versions released with unobfuscated mappings (e.g., experimental snapshots like 1.21.11_unobfuscated or 25w45a_unobfuscated).

Features

List Versions: See available Minecraft versions, including special "unobfuscated" releases.
Search Classes: Find class files within a specific version's JAR.
Decompile: Decompile .class files on-the-fly using Vineflower (WASM) to view readable Java source code.
Caching: Efficiently caches downloaded JARs and open ZIP file handles for performance.

Tools

`list_versions`

Lists available Minecraft versions.

type: Filter by release, snapshot, or unobfuscated (recommended).
limit: Number of versions to return.

`search_classes`

Searches for a class in a specific version.

version: The version ID (e.g., 1.21.11_unobfuscated).
query: The class name to search for (e.g., SharedConstants).

`decompile_class`

Decompiles a specific class.

version: The version ID.
className: The full path to the class (e.g., net/minecraft/SharedConstants).

Setup

npm install
npm run build

Usage

Configure your MCP client to run:

{
  "mcpServers": {
    "mcsrc": {
      "command": "node",
      "args": ["/path/to/mcsrc-mcp/dist/index.js"]
    }
  }
}

IDE Access from Windows (via HTTP/SSE)

If your IDE is running on Windows and cannot directly spawn the WSL process, you can run the server in HTTP mode.

Start the server in WSL:
```
npm run start:http
```
This will start an HTTP server on port 3000 (accessible as localhost:3000 from Windows).
Configure your MCP Client: Point your client to the Streamable HTTP endpoint:
- URL: http://localhost:3000/mcp
(No arguments needed for the client configuration, just the URL).