AI导哈

API查询服务

一个基于Model Context Protocol (MCP)的服务器，用于查询外部API并返回结构化数据，适用于AI工具集成。

  • by Tiago-Alves-Dev
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 tiago-alves-dev/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.

相关 MCP