MCP Server API

MCP Server - Consulta API Externa (TabNews)

Este projeto foi desenvolvido com o intuito de demonstrar o poder do Model Context Protocol (MCP) consultando APIs externas e retornando dados tratados.

🎯 Objetivo do Projeto

Este projeto implementa um servidor Model Context Protocol (MCP) que demonstra como o MCP pode ser utilizado para:

• Consultar APIs externas de forma simples e eficiente
• Retornar dados estruturados em formato JSON
• Integrar com ferramentas de IA através do protocolo MCP

📡 Funcionalidade

• Tool tabnews-articles: Consulta o endpoint público do TabNews (https://www.tabnews.com.br/api/v1/contents) e retorna os dados dos artigos mais recentes em formato JSON tratado.

🛠️ Pré-requisitos

• Node.js 18 ou superior

⚙️ Instalação

1. Clone este repositório ou copie os arquivos para um diretório local
2. Instale as dependências:

npm install

🚀 Como Executar

1. Iniciar o Servidor MCP

node index.js

O servidor será iniciado na porta 3000 e expõe o endpoint MCP em:

POST http://localhost:3000/mcp

2. Interface de Teste do MCP ⭐

Para testar e visualizar o funcionamento do MCP de forma interativa, use o comando:

npx @modelcontextprotocol/inspector node index.js

Este comando abre a interface de teste que o MCP disponibiliza, permitindo que você:

• Visualize todas as ferramentas disponíveis
• Teste as chamadas de forma interativa
• Veja os dados retornados em tempo real

🧪 Testando a Ferramenta

Via Interface de Teste (Recomendado)

Use o comando do inspector mencionado acima para uma experiência interativa.

📁 Estrutura dos Arquivos

• index.js: Código principal do servidor MCP
• package.json: Dependências e metadados do projeto
• README.md: Este arquivo de documentação

🔍 Sobre o TabNews

O projeto consulta o TabNews, uma plataforma brasileira de conteúdo, e retorna dados que podem ser tratados com JSON.stringify para uso em aplicações de IA.

📝 Observações

• O servidor utiliza o transporte HTTP Streamable do MCP, compatível com clientes modernos
• O endpoint do TabNews é público e não requer autenticação
• O projeto pode ser expandido para incluir mais ferramentas ou recursos MCP conforme necessário

Desenvolvido para demonstração do poder do Model Context Protocol com integração a APIs públicas externas.