Servidor de Ferramentas MCP (STDIO)

Este repositório contém um servidor Model Context Protocol (MCP) em Node.js que se comunica via stdin/stdout (transporte STDIO). Ele expõe um conjunto de ferramentas úteis, incluindo um gerador de saudações e um cliente para buscar notícias de tecnologia do TabNews.

Ferramentas Disponíveis

Atualmente, o servidor oferece as seguintes ferramentas:

1. generate-greeting

   • Descrição: Gera uma saudação personalizada com a data e hora atuais.
   • Parâmetros:
     • name (string, opcional): O nome da pessoa a ser saudada. Padrão: "Amigo".
     • language (string, opcional): O idioma da saudação. Padrão: "pt-BR".

2. fetch-tabnews-articles

   • Descrição: Busca os últimos artigos do TabNews, uma plataforma brasileira de conteúdo técnico.
   • Parâmetros:
     • limit (number, opcional): Número máximo de artigos para retornar. Padrão: 10, Máximo: 30.

Pré-requisitos

• Node.js ≥ 18
• npm (já incluído no Node)

Instalação

npm install

Execução

npm start

Testando com MCP Inspector

O MCP Inspector permite interagir com servidores STDIO tanto por CLI quanto pela interface web.

1. CLI

Listar ferramentas:

npx @modelcontextprotocol/inspector --cli node index.js --method tools/list

Chamar a ferramenta generate-greeting:

npx @modelcontextprotocol/inspector --cli node index.js \
  --method tools/call \
  --tool-name generate-greeting \
  --tool-arg name=Lucas

Chamar a ferramenta fetch-tabnews-articles (buscando 5 artigos):

npx @modelcontextprotocol/inspector --cli node index.js \
  --method tools/call \
  --tool-name fetch-tabnews-articles \
  --tool-arg '{"limit": 5}'

2. UI

npx @modelcontextprotocol/inspector

1. Copie o link com token gerado no terminal e abra-o no navegador.
2. Clique em Add server → New STDIO.
3. Configure:
   • Command: node
   • Args: index.js
4. Salve e clique em Connect para listar e usar as ferramentas disponíveis.

Estrutura do Projeto

├── index.js         # Lógica do servidor MCP e das ferramentas
├── package.json     # Dependências e scripts
└── README.md        # Esta documentação

Scripts npm

| Script | Descrição | | :----- | :-------------------------- | | start | Inicia o servidor MCP STDIO |

Licença

Distribuído sob a licença ISC. Sinta-se livre para usar, modificar e compartilhar.