MCP Demo Server Java
andreykolchev/mcp-server
Servidor MCP em Java com exemplos de tools e transporte HTTP
Ver no GitHubUm servidor MCP (Model Context Protocol) minimalista construído com Java 17, MCP Java SDK e Jetty. Demonstra como implementar ferramentas customizadas (tools) e registrá-las para uso com Claude, incluindo exemplos de weather e cálculo de soma.
Instalação
npx convez-ai andreykolchev/mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Aprender a implementar servidores MCP em Java
- Criar tools customizadas para integrar com Claude
- Prototipar integrações via HTTP/JSON-RPC com MCP
Veredito

Projeto educacional sólido para entender a arquitetura MCP em Java. Bem estruturado com exemplos funcionais, mas carece de documentação detalhada sobre deployment e casos de uso além dos demos.
README
A tradução para o português deste README ainda está na fila.
MCP Demo Server
A minimal Model Context Protocol server built with the MCP Java SDK and Jetty.
Stack
- Java 17
- MCP Java SDK 0.17.2
- Jetty 12 (HTTP transport)
- Jackson (JSON serialization)
- SLF4J + Logback (logging)
Project structure
src/main/java/org/example/
├── MCPServer.java # Entry point — wires transport and registers tools
├── JettyHttpTransport.java # Stateless HTTP/JSON-RPC transport over Jetty
├── SchemaUtils.java # Derives McpSchema.JsonSchema from a record class via reflection
│ # @Description annotation for field descriptions
├── WeatherTool.java # get_weather tool — Request/Response DTOs + handler
└── SumTool.java # calculate_sum tool — Request/Response DTOs + handler
Running
mvn compile exec:java -Dexec.mainClass=org.example.MCPServer
Server starts on http://localhost:8080/mcp.
Adding a new tool
- Create a new class (e.g.
MyTool.java) with:Requestrecord — fields annotated with@SchemaUtils.DescriptionResponserecorddefinition()— returnsMcpSchema.ToolusingSchemaUtils.fromRecord(Request.class)execute(Request)— business logic, throwsIllegalArgumentExceptionfor invalid input
- Register it in
MCPServer.java:.toolCall(MyTool.definition(), typed(mapper, MyTool.Request.class, MyTool::execute))
API
All requests are POST http://localhost:8080/mcp with Content-Type: application/json.
See _doc/test.http for ready-to-run examples including error cases.
Tools
| Tool | Arguments | Description |
|---|---|---|
get_weather | city: string | Returns temperature and condition for a city |
calculate_sum | a: number, b: number | Returns the sum of two numbers |