Skip to main content
Glama
Sign In
VhMuzini

mcp-server-example

by VhMuzini
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

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: mcp-snippetbox

Versao TypeScript (raiz do repositorio)

Ferramentas disponiveis

Ferramenta

Descricao

list_notes

Lista todas as notas cadastradas

get_note

Busca uma nota especifica pelo ID

create_note

Cria uma nova nota

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Notes MCP

    jasongilman
    F
    license
    A
    quality
    B
    maintenance
    Provides an in-memory notebook interface with tools to create, retrieve, list, update, and delete notes, designed to test agent behavior through realistic MCP tool interactions.
    5
    1
    -

  • mcp-snippetbox

    AAAdiaosbrk
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.
    MIT

  • notes-mcp

    suhail1060
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables managing plain-text notes on disk through MCP resources, tools, and prompts, so natural-language requests can create, read, search, delete, and summarize notes via an interactive client.
    MIT