java-mcp-server-generator Skill (awesome-copilot) for Claude Code: What It Does and How to Install It

• Maven layout with pom.xml, MCP Java SDK 2.x and a shade plugin

  Maven by default. For Gradle it reads references/gradle.md instead.

  Try: “Create an MCP server in Java that lets Claude query my Postgres database”

  Write · Step 1: Create the project

• Starts from a divide-tool template and swaps in your tools

  Gives each tool a JSON Schema and description, and adds resources and prompts only if you ask. Stdio is the default transport.

  Write · Step 2: Write the server

• JUnit tests start the server as a subprocess and call each tool

  One test per tool and per error result, over real stdio.

  Runs code · Step 3: Write the tests

• mvn verify, fix failures, repeat

  Builds target/mcp-server-demo-0.1.0.jar. Maven downloads the dependencies.

  Runs code · Step 4: Build until tests pass

• Writes .vscode/mcp.json, or the same command in claude_desktop_config.json

  Also tells you how to start the server with java -jar and how to test it with the MCP Inspector.

  Write · Step 5: Configure the client

• gradle wrapper once, then ./gradlew build installDist

  From references/gradle.md. It says not to use ./gradlew run as the client command.

  Runs code · Gradle variant

• Servlet or Spring Boot server for a remote MCP server

  From references/streamable-http.md, read only when you ask for a remote server. It says to set a Host and Origin check and to add authorization yourself.

  Write · Streamable HTTP variant

• SDK 2.x builder rules, tool-name limits, stdout reserved for the protocol

  Warns against copying examples from SDK 0.x and 1.x and against the deprecated SSE transports.

  Read · Gotchas

Watch out for

• It builds and runs code on your machine

  Step 4 runs mvn verify, which downloads dependencies and runs the tests, and the tests start the server as a subprocess. The Gradle variant runs gradle wrapper and ./gradlew build installDist. Our advice: read the generated code before you build. github.com

• It can edit your Claude Desktop config

  Step 5 says to put the server command and args in claude_desktop_config.json under mcpServers. Our advice: check the diff so you do not overwrite other servers. github.com

• Remote servers need your own security setup

  references/streamable-http.md says the HTTP transports do not check Host and Origin by default, embedded Tomcat listens on all network interfaces and the SDK has no authorization. The file tells you to set the validator and put authentication in front. github.com

• The plugin route also adds an agent

  The java-mcp-development plugin lists this skill and the java-mcp-expert agent. That agent's file lists no tools. github.com