mcp-server-test

salvatoreDeploy/mcp-server-test

3.2

If you are the rightful owner of mcp-server-test and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This repository contains a Model Context Protocol (MCP) server in Node.js that communicates via STDIO, offering tools like a greeting generator and a tech news fetcher.

Tools

  1. generate-greeting

    Generates a personalized greeting with the current date and time.

  2. fetch-tabnews-articles

    Fetches the latest articles from TabNews, a Brazilian technical content platform.

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

ScriptDescrição
startInicia o servidor MCP STDIO

Licença

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