mcp
Java implementation of the MCP protocol server
Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio spullara-mcp-server java -jar mcp-server.jar \ --env MCP_LOG_LEVEL="Log verbosity (e.g., INFO, DEBUG)" \ --env MCP_SERVER_PORT="Port to run the MCP server on (default 4481)"
How to use
This MCP server bundle provides a Minecraft Coder Pack (MCP) style environment for deobfuscating and mapping Minecraft server/client code. The server exposes tooling to map and inspect MCP-compatible artifacts, allowing you to run the MCP workflow locally. Start the server with the provided command, then use the built-in tooling to load a Minecraft version, generate mappings, and apply obfuscation mappings to your codebase. Typical operations include initializing an MCP workspace, updating mappings for a target Minecraft version, and exporting the resulting source or mapping files for integration into your development workflow.
How to install
Prerequisites:
- Java JRE/JDK (8+ recommended)
- Sufficient disk space for MCP mappings and artifacts
- Optional: Docker if you prefer containerized execution
Steps:
- Prepare Java environment
- Ensure java -version returns a valid Java runtime.
- Acquire the MCP server jar
- Place mcp-server.jar in a working directory or build it from source if you have a release artifact.
- Configure environment (optional)
- Create a .env file or export MCP_SERVER_PORT and MCP_LOG_LEVEL as needed.
- Run the MCP server
- java -jar mcp-server.jar
- Or, if using the provided script/package, use the appropriate start command.
- Verify the server is running
- Check logs for listening port and mapping status.
- Use MCP tooling
- Connect to the server's API or CLI (as exposed by this build) to load Minecraft versions, generate mappings, and export artifacts.
Additional notes
Notes:
- If you encounter port conflicts, set MCP_SERVER_PORT to an available port via the environment variable.
- Use MCP_LOG_LEVEL=DEBUG for more verbose output when debugging issues with mappings.
- Ensure you are using a compatible Java version for the MCP server jar.
- If using an external editor or build system, map the output directories (mappings, sources) to your project structure.
- This documentation uses a standard MCP-style workflow; consult the repository's specific README or help commands for exact CLI options and available mappings.
