aula-mcp
v1.0.1
Published
Servidor MCP simples com resource de saudação
Readme
Servidor MCP de Saudação 🎉
Um servidor MCP (Model Context Protocol) simples que fornece um resource de saudação.
📋 Funcionalidades
- Resource de Saudação: Retorna uma mensagem de boas-vindas personalizada
- URI do Resource:
saudacao://cumprimento - Formato: Texto simples (text/plain)
🚀 Como Usar
1. Instalar Dependências
npm install2. Iniciar o Servidor
npm start3. Testar com Claude Desktop
Para usar este servidor com o Claude Desktop, adicione a seguinte configuração no arquivo de configuração do Claude:
No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"saudacao": {
"command": "node",
"args": ["/caminho/completo/para/seu/projeto/index.js"]
}
}
}4. Testando Manualmente
Você pode testar o servidor usando qualquer cliente MCP ou ferramenta que suporte o protocolo.
Exemplo de comandos MCP:
Listar Resources:
{
"jsonrpc": "2.0",
"id": 1,
"method": "resources/list"
}Ler Resource:
{
"jsonrpc": "2.0",
"id": 2,
"method": "resources/read",
"params": {
"uri": "saudacao://cumprimento"
}
}🔧 Estrutura do Código
O servidor implementa:
- ListResourcesRequestSchema: Lista todos os resources disponíveis
- ReadResourceRequestSchema: Lê o conteúdo de um resource específico
- StdioServerTransport: Comunicação via stdin/stdout
📝 Exemplo de Saída
Quando você solicitar o resource saudacao://cumprimento, receberá uma mensagem como:
🎉 Olá! Seja muito bem-vindo(a)!
Esta é uma saudação calorosa do seu servidor MCP!
📅 Data/Hora atual: 22/01/2025, 08:03:17
🚀 Servidor: saudacao-server v1.0.0
💡 Este é um exemplo simples de como criar um resource em MCP
Que seu dia seja incrível! ✨🛠️ Desenvolvido com
- Node.js
- @modelcontextprotocol/sdk
- JavaScript ES Modules
📚 Próximos Passos
Você pode expandir este servidor adicionando:
- Mais resources (arquivos, dados, APIs)
- Tools (funções que o LLM pode executar)
- Prompts (templates de prompt reutilizáveis)
- Diferentes transportes (HTTP, WebSocket)
🔍 Debug
Se você encontrar problemas, verifique:
- Se as dependências estão instaladas
- Se a versão do Node.js é compatível (>=18)
- Os logs de erro no console
