vedovelli/mcp-server

🚀 Servidor MCP Multifuncional

Um servidor MCP (Model Context Protocol) que fornece ferramentas úteis para saudações personalizadas e consulta de conteúdo técnico brasileiro.

✨ Características

👋 Ferramenta de Saudação

• 🌅 Saudações personalizadas baseadas no horário do dia
• 📅 Data e hora atual formatadas em português brasileiro
• 🌍 Suporte a múltiplos idiomas (Português, Inglês, Espanhol)
• 🎯 Nome personalizado na saudação
• ⏰ Fuso horário brasileiro (America/Sao_Paulo)

📰 Integração com TabNews

• 🔄 Consulta em tempo real da API do TabNews
• 📋 Lista de artigos com títulos, autores e URLs
• 🪙 Informações sobre TabCoins (pontuação da comunidade)
• 📅 Datas de publicação formatadas
• 🌟 Links diretos para os artigos originais

🔧 Instalação e Uso

🚀 Uso com NPX (Recomendado)

# Executar diretamente (sem instalação)
npx mcp-greeting-tabnews-server

# Ver ajuda e opções disponíveis
npx mcp-greeting-tabnews-server --help

# Testar com MCP Inspector
npx mcp-greeting-tabnews-server --inspector

# Ver informações das ferramentas
npx mcp-greeting-tabnews-server --info

📦 Instalação Local (Para Desenvolvimento)

1. Instalar dependências:

npm install

2. Executar o servidor:

npm start

🌐 Instalação Global

# Instalar globalmente
npm install -g mcp-greeting-tabnews-server

# Executar
mcp-greeting-tabnews

🛠️ Ferramentas Disponíveis

friendly_greeting

Gera uma saudação amistosa e personalizada com data/hora atual.

Parâmetros:

• name (opcional): Nome da pessoa para personalizar a saudação (padrão: "Amigo")
• language (opcional): Idioma da saudação - pt, en, ou es (padrão: "pt")

Exemplo de resposta:

🌅 Bom dia, João!

🎉 É um prazer te cumprimentar!

📅 Hoje é segunda-feira, 22 de janeiro de 2024
⏰ São exatamente 09:30:45 (horário de Brasília)

✨ Espero que você esteja tendo um dia incrível!
💫 Estou aqui para te ajudar no que precisar.

🚀 Vamos fazer coisas incríveis juntos!

fetch_tabnews_articles

Busca os últimos artigos do TabNews, uma plataforma brasileira de conteúdo técnico onde desenvolvedores compartilham conhecimento e experiências.

Parâmetros:

• limit (opcional): Número máximo de artigos para retornar (padrão: 10, máximo: 30)

Exemplo de resposta:

📰 Últimos 5 artigos do TabNews

🕐 Consultado em: domingo, 8 de junho de 2025 às 10:30

---

**1. Fechei um projeto de R$20.000 em 20 minutos**
👤 Por: alone
📅 Publicado: 08/06/2025
🪙 TabCoins: 1
🔗 URL: https://www.tabnews.com.br/alone/fechei-um-projeto-de-r20-000-em-20-minutos

**2. O débito técnico nunca será pago**
👤 Por: DevPHP
📅 Publicado: 06/06/2025
🪙 TabCoins: 12
🔗 URL: https://www.tabnews.com.br/DevPHP/o-debito-tecnico-nunca-sera-pago

---

💡 **Sobre o TabNews:** Uma plataforma brasileira de conteúdo técnico onde desenvolvedores compartilham conhecimento e experiências.
🌟 Acesse: https://www.tabnews.com.br

📋 Como Testar

Opção 1: Usando MCP Inspector

npx @modelcontextprotocol/inspector node index.js

Opção 2: Integração com Claude Desktop

Adicione no seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "greeting-tabnews": {
      "command": "npx",
      "args": ["mcp-greeting-tabnews-server"]
    }
  }
}

Alternativa para desenvolvimento local:

{
  "mcpServers": {
    "greeting-tabnews": {
      "command": "node",
      "args": ["caminho/para/seu/index.js"]
    }
  }
}

Opção 3: Testando via linha de comando

# Saudação básica
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"friendly_greeting","arguments":{}}}' | node index.js

# Saudação com nome personalizado
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"friendly_greeting","arguments":{"name":"Maria","language":"pt"}}}' | node index.js

# Saudação em inglês
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"friendly_greeting","arguments":{"name":"John","language":"en"}}}' | node index.js

# Buscar artigos do TabNews (padrão: 10 artigos)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_tabnews_articles","arguments":{}}}' | node index.js

# Buscar apenas 5 artigos do TabNews
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_tabnews_articles","arguments":{"limit":5}}}' | node index.js

🏗️ Estrutura do Projeto

mcp-server/
├── index.js          # Servidor MCP principal
├── package.json      # Configurações e dependências
└── README.md         # Esta documentação

🔍 Detalhes Técnicos

• Protocolo: MCP (Model Context Protocol)
• Transporte: stdio (entrada/saída padrão)
• SDK: @modelcontextprotocol/sdk
• Formato: ES Modules
• Timezone: America/Sao_Paulo

🐛 Solução de Problemas

Erro de dependências

npm install @modelcontextprotocol/sdk

Servidor não inicia

Verifique se o Node.js está instalado (versão 18+ recomendada):

node --version

Problemas de permissão

No Linux/macOS, torne o arquivo executável:

chmod +x index.js

🚀 Próximos Passos

Este servidor pode ser estendido com:

• 🌡️ Informações meteorológicas
• 📰 Notícias do dia
• 💱 Cotações de moedas
• 🎲 Mensagens motivacionais aleatórias
• 📊 Estatísticas personalizadas

Desenvolvido com ❤️ usando Model Context Protocol