mcp-greeting-server

v1.0.0

Published

7 months ago

Servidor MCP simples com ferramenta de saudação dinâmica

0High
0Medium
0Low

rafael.sousa

mcp greeting server model-context-protocol tabnews claude

🌟 Servidor MCP de Saudação

Um servidor MCP (Model Context Protocol) simples que fornece saudações amistosas com dados dinâmicos como data e hora atuais.

📋 Funcionalidades

Saudação Personalizada: Gera saudações baseadas no horário do dia
Dados Dinâmicos: Inclui data, hora e dia da semana atuais
Frases Amistosas: Mensagens aleatórias para tornar a interação mais calorosa
Fuso Horário: Configurado para horário de Brasília (UTC-3)
Personalização: Permite personalizar o nome da pessoa

🚀 Instalação e Uso

Opção 1: Via NPX (Recomendado para usuários finais)

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

# Usar com MCP Inspector
npx @modelcontextprotocol/inspector npx mcp-greeting-server

Opção 2: Desenvolvimento Local

Instalar dependências:

npm install

Executar o servidor:

npm start

Modo desenvolvimento (com auto-reload):

npm run dev

Testar com MCP Inspector:

npm run inspect

Opção 3: Instalação Global

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

# Executar de qualquer lugar
mcp-greeting-server

Nota: Este projeto utiliza o SDK oficial do Model Context Protocol v1.13.1, que inclui as funcionalidades mais recentes e melhorias de performance.

🧪 Testando com MCP Inspector

O MCP Inspector é uma ferramenta visual oficial para testar servidores MCP em uma interface web interativa.

# Executar o MCP Inspector
npm run inspect

# Ou executar diretamente
npx @modelcontextprotocol/inspector node index.js

O Inspector abrirá uma interface web onde você pode:

✅ Visualizar ferramentas disponíveis
✅ Testar chamadas de ferramentas interativamente
✅ Ver respostas em tempo real
✅ Debuggar problemas de conectividade
✅ Explorar o esquema JSON das ferramentas

Exemplo de uso do Inspector:

Execute npm run inspect
Acesse a URL mostrada no terminal (geralmente http://localhost:3000)
Teste a ferramenta friendly_greeting com diferentes parâmetros
Visualize as respostas formatadas

🛠️ Ferramentas Disponíveis

`friendly_greeting`

Gera uma saudação amistosa e personalizada com informações de data e hora.

Parâmetros:

name (string, opcional): Nome da pessoa para saudar (padrão: "Amigo")
language (string, opcional): Idioma da saudação ("pt" para português)

Exemplo de uso:

{
  "name": "friendly_greeting",
  "arguments": {
    "name": "Maria",
    "language": "pt"
  }
}

Exemplo de resposta:

🌟 Bom dia, Maria!

Que seu dia seja repleto de alegria!

📅 **Data**: segunda-feira, 22 de janeiro de 2024
🕐 **Hora**: 09:15:32
🌍 **Fuso Horário**: America/Sao_Paulo (UTC-3)
📆 **Dia da Semana**: segunda-feira

---
_Saudação gerada em: 2024-01-22T12:15:32.123Z_

`get_tabnews_articles`

Consulta os artigos mais recentes do TabNews e retorna título, autor, URL e outras informações.

Parâmetros:

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

Exemplo de uso:

{
  "name": "get_tabnews_articles",
  "arguments": {
    "limit": 5
  }
}

Exemplo de resposta:

📰 **5 Artigos Mais Recentes do TabNews**

**1. Eu não acredito em Micro-SaaS**
👤 **Autor**: moacirmoda
🪙 **TabCoins**: 7
📅 **Publicado**: 23/01/2024, 14:04
🔗 **Link**: https://moacirmoda.substack.com/p/eu-nao-acredito-em-micro-saas

**2. Conteúdo de C#**
👤 **Autor**: blima1504
🪙 **TabCoins**: 4
📅 **Publicado**: 22/01/2024, 19:32
🔗 **Link**: https://www.tabnews.com.br/blima1504/conteudo-de-c

---
_Dados obtidos da API do TabNews em: 23/01/2024, 15:30:45_

🔧 Configuração para Clientes MCP

Claude Desktop (Windows 11)

1. Localizar o arquivo de configuração:

O arquivo de configuração do Claude Desktop no Windows está localizado em:

%APPDATA%\Claude\claude_desktop_config.json

2. Abrir o arquivo de configuração:

Pressione Win + R
Digite: %APPDATA%\Claude
Abra ou crie o arquivo claude_desktop_config.json

3. Configurar o servidor MCP:

Opção A: Via NPX (Recomendado)

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

Opção B: Caminho local (desenvolvimento)

{
  "mcpServers": {
    "greeting-server": {
      "command": "node",
      "args": ["C:\\git\\Rocketseat\\youtube\\mcp-server\\index.js"],
      "env": {}
    }
  }
}

Opção C: Instalação global

{
  "mcpServers": {
    "greeting-server": {
      "command": "mcp-greeting-server",
      "env": {}
    }
  }
}

4. Reiniciar o Claude Desktop:

Feche completamente o Claude Desktop
Abra novamente para carregar a nova configuração

Outros Clientes MCP

O servidor usa transporte stdio padrão, sendo compatível com qualquer cliente MCP que suporte este protocolo. Desenvolvido com SDK v1.13.1, oferece compatibilidade total com as especificações mais recentes do MCP.

📝 Estrutura do Projeto

mcp-greeting-server/
├── index.js          # Servidor MCP principal
├── package.json       # Configurações e dependências
└── README.md          # Este arquivo

🎯 Características Técnicas

Protocolo: Model Context Protocol (MCP) v1.13+
Transporte: stdio (entrada/saída padrão)
Linguagem: JavaScript (ES Modules)
SDK: @modelcontextprotocol/sdk v1.13.1
Compatibilidade: Node.js 18+
Teste Visual: Compatível com MCP Inspector oficial
Debugging: Interface visual para desenvolvimento e testes

🕒 Lógica de Saudação

O servidor determina a saudação baseada no horário atual:

05:00 - 11:59: "Bom dia"
12:00 - 17:59: "Boa tarde"
18:00 - 04:59: "Boa noite"

🔄 Frases Amistosas

O servidor seleciona aleatoriamente uma das seguintes frases:

"Espero que você esteja tendo um ótimo dia!"
"Que seu dia seja repleto de alegria!"
"Desejo que tudo corra muito bem para você!"
"Que você tenha um dia maravilhoso!"
"Espero que você esteja se sentindo bem!"

✨ Melhorias da Versão Atual

SDK v1.13.1 Benefícios:

Performance Aprimorada: Melhor gestão de memória e processamento
Estabilidade: Correções de bugs e melhorias de conectividade
Compatibilidade: Suporte total às especificações MCP mais recentes
Segurança: Implementações de segurança aprimoradas
Debugging: Melhor sistema de logs e tratamento de erros

🔍 Benefícios do MCP Inspector:

Interface Visual: Teste ferramentas através de uma UI amigável
Tempo Real: Veja respostas instantaneamente
Debugging Visual: Identifique problemas rapidamente
Exploração de Schema: Visualize estruturas JSON das ferramentas
Sem Código: Teste sem escrever código cliente
Desenvolvimento Rápido: Ideal para prototipagem e testes

🐛 Solução de Problemas

Erro ao instalar dependências

# Limpar cache npm
npm cache clean --force
npm install

Servidor não inicia

Verifique se o Node.js está instalado (versão 18+)
Verifique se as dependências foram instaladas corretamente
Verifique os logs de erro no console

MCP Inspector não conecta

Certifique-se de que o servidor index.js existe e é executável
Verifique se as dependências foram instaladas (npm install)
Verifique se a porta não está sendo usada por outro processo
Verifique os logs no terminal para mensagens de erro

Claude Desktop não reconhece o servidor (Windows)

Verificar o caminho do arquivo:
- Use o caminho absoluto completo (ex: C:\\git\\Rocketseat\\youtube\\mcp-server\\index.js)
- Use barras duplas \\ nos caminhos do Windows
Verificar se o Node.js está no PATH:
```
node --version
```

Testar o servidor manualmente:

cd C:\git\Rocketseat\youtube\mcp-server
node index.js

Verificar logs do Claude Desktop:
- Abra o Claude Desktop
- Vá em configurações e procure por logs de erro
Arquivo de configuração deve estar correto:
- Localização: %APPDATA%\Claude\claude_desktop_config.json
- Formato JSON válido
- Sem comentários no JSON
Reiniciar completamente:
- Feche o Claude Desktop completamente (verifique na bandeja do sistema)
- Reabra o aplicativo

📦 Publicação no NPM

Para disponibilizar seu servidor MCP via NPX globalmente:

Pré-requisitos:

Conta no NPM: Crie uma conta em npmjs.com
Nome único: Verifique se o nome do pacote está disponível

Passos para publicação:

1. Preparar o pacote:

# Atualizar informações do autor no package.json
# Definir repositório git (se aplicável)
# Verificar se tudo está funcionando
npm test
npm run inspect

2. Fazer login no NPM:

npm login

3. Verificar configuração:

# Verificar se não há arquivos desnecessários
npm pack --dry-run

# Testar instalação local
npm install -g .

4. Publicar:

# Primeira publicação
npm publish

# Atualizações futuras
npm version patch  # ou minor/major
npm publish

5. Testar a publicação:

# Testar instalação global
npx mcp-greeting-server

# Verificar no site do NPM
# https://www.npmjs.com/package/mcp-greeting-server

Exemplo de configuração final do package.json:

{
  "name": "mcp-greeting-server",
  "version": "1.0.0",
  "description": "Servidor MCP com saudações dinâmicas e consulta ao TabNews",
  "author": "Seu Nome <[email protected]>",
  "license": "ISC",
  "bin": {
    "mcp-greeting-server": "./index.js"
  },
  "repository": {
    "type": "git", 
    "url": "https://github.com/seu-usuario/mcp-greeting-server.git"
  }
}

Nota: Após a publicação, qualquer pessoa poderá usar npx mcp-greeting-server para executar seu servidor!

📄 Licença

ISC License

🤝 Contribuindo

Sinta-se à vontade para contribuir com melhorias, correções de bugs ou novas funcionalidades!

Desenvolvido com ❤️ usando Model Context Protocol