convez.ai
MCP ServerIntegração & APIsIntermediário
andreykolchev

MCP Demo Server Java

andreykolchev/mcp-server

Servidor MCP em Java com exemplos de tools e transporte HTTP

Ver no GitHub
InicialPluginScore · de 0 a 100

Um 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-server

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

  1. Create a new class (e.g. MyTool.java) with:
    • Request record — fields annotated with @SchemaUtils.Description
    • Response record
    • definition() — returns McpSchema.Tool using SchemaUtils.fromRecord(Request.class)
    • execute(Request) — business logic, throws IllegalArgumentException for invalid input
  2. 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

ToolArgumentsDescription
get_weathercity: stringReturns temperature and condition for a city
calculate_suma: number, b: numberReturns the sum of two numbers
Ver o original no GitHub

Bom para

Relacionados