mcp-server-example

Exemplos didaticos de um MCP server (Model Context Protocol), em duas linguagens:

• TypeScript / Node.js — na raiz deste repositorio

• Java — na pasta java-example/

Este projeto existe para mostrar a estrutura minima de um servidor MCP: como declarar ferramentas ("tools"), como responde-las e como conectar tudo via stdio.

O que e MCP?

MCP (Model Context Protocol) e um protocolo aberto, criado pela Anthropic, que permite que assistentes de IA se conectem a fontes de dados e ferramentas externas de forma padronizada. Em vez de cada integracao ter seu proprio formato, um MCP server expoe um conjunto de ferramentas que qualquer cliente compativel (como o Claude Desktop) consegue descobrir e usar.

Related MCP server: Notes MCP

Versao TypeScript (raiz do repositorio)

Ferramentas disponiveis

Os dados sao mantidos em memoria (um array), so para fins de demonstracao. Em um caso real, aqui entraria uma chamada a uma API externa (por exemplo, a API da Vercel, do GitHub, um banco de dados, etc).

Como rodar

npm install
npm run build
npm start

O servidor roda via stdio (entrada/saida padrao), que e o transporte mais comum para MCP servers usados localmente.

Como conectar no Claude Desktop

Adicione a configuracao abaixo no arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-server-example": {
      "command": "node",
      "args": ["/caminho/absoluto/para/build/index.js"]
    }
  }
}

Reinicie o Claude Desktop e as ferramentas list_notes, get_note e create_note estarao disponiveis na conversa.

Estrutura do projeto (TypeScript)

src/
  index.ts       # Implementacao do servidor MCP
package.json
tsconfig.json

Versao Java

Veja o README da pasta java-example para detalhes (SDK oficial Java do MCP, versao 2.0.1, Java 21).

Proximos passos (ideias de evolucao)

• Trocar o array/mapa em memoria por chamadas reais a uma API (ex: Vercel REST API)

• Adicionar autenticacao via variavel de ambiente (ex: VERCEL_TOKEN)

• Adicionar tratamento de erros mais robusto

• Escrever testes para cada ferramenta

Licenca

MIT