Skip to main content
Glama
Meu MCP

Meu MCP

by RodrigoSaka

Meu MCP

Servidor MCP mínimo em TypeScript, executado por stdio, para demonstrar como expor uma ferramenta a clientes compatíveis com Model Context Protocol.


Funcionalidade

O servidor disponibiliza uma ferramenta simples e validada com Zod.

  • Ferramenta: saudacao

  • Entrada obrigatória: nome

  • Saída: mensagem de saudação em texto e em formato estruturado

  • Transporte: stdio

Exemplo de entrada:

{
  "nome": "Ada"
}

Exemplo de resposta:

Olá, Ada! Bem-vindo ao meu servidor MCP.

Requisitos

Dependências necessárias para desenvolver, executar e testar o projeto.

  • Node.js 20 ou mais recente

  • npm


Instalação e compilação

Prepare as dependências e gere os arquivos JavaScript consumidos pelos clientes MCP.

npm install
npm run build

Execução local

Use o modo de desenvolvimento ao alterar o código ou execute a versão já compilada.

npm run dev
npm start

O processo fica aguardando mensagens MCP pela entrada padrão. Logs devem ser escritos em stderr, pois a saída padrão é reservada ao protocolo.


Consumir o servidor

As configurações completas foram separadas para facilitar o uso em diferentes clientes.

Consulte USAGE.md para configurar:

  • MCP Inspector

  • Codex

  • Claude Code e Claude Desktop

  • Devin

Os clientes locais iniciam o processo automaticamente. Não mantenha npm start aberto quando o cliente já estiver configurado para executar o servidor.


Estrutura do projeto

Arquivos principais responsáveis pelo servidor, transporte e validação.

.
├── src/
│   ├── index.ts
│   └── server.ts
├── test/
│   └── server.test.ts
├── USAGE.md
├── package.json
├── tsconfig.json
└── tsconfig.test.json

Verificação

Valide os tipos, compile o projeto e execute o teste de integração.

npm run typecheck
npm run build
npm test

Available Tools

1 tool
saudacaoCriar saudaçãoA

Cria uma mensagem de saudação para uma pessoa.

Inputs: nome (required). Returns: mensagem

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there is no possibility of overlap or ambiguity. The tool has a clear, single purpose.

    Naming Consistency5/5

    With only one tool named 'saudacao', there is no naming pattern to violate. The name is clear and accurately reflects its function.

    Tool Count2/5

    A single trivial tool is far too few for a typical MCP server, which usually exposes a broader set of related operations. Even for a greeting service, one operation feels insufficient.

    Completeness3/5

    The single tool covers the basic greeting use case, but there are no complementary operations (e.g., formatting variations, language selection) or obvious extensions, leaving the surface noticeably thin.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      C
      quality
      D
      maintenance
      A simple MCP server that provides a basic greeting tool for saying hello with customizable names. Serves as a boilerplate template for developers to quickly create and deploy new MCP servers.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A minimal learning-focused MCP server that demonstrates core primitives like tools and resources through simple greeting functions. It provides a foundational example for connecting AI models to external data using both Streamable HTTP and stdio transports.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      A simple MCP server that exposes a 'greet' tool which returns a friendly greeting for a given name.
      10 npm
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables a simple greeting tool over MCP, demonstrating schema validation and transport communication.
      ISC