MCP Low-Level Server Streamable HTTP

Uma implementação de servidor MCP de baixo nível com suporte a HTTP transmissível, configurada por meio de variáveis de ambiente.

Documentação

Como criar um servidor MCP usando Low-Level Server e Streameable HTTP 🚀🖥️✨

Este é um servidor MCP baseado em TypeScript que implementa um sistema simples de notas. Demonstra conceitos-chave de MCP fornecendo:

  • 📄 Recursos que representam notas de texto com URIs e metadados
  • 🛠️ Ferramentas para criar novas notas
  • 💡 Prompts para gerar resumos de notas

Características 🌟

Recursos 📚

  • 📑 Lista e acessa notas por meio de URIs note://
  • 🏷️ Cada nota tem título, conteúdo e metadados
  • 📝 Tipo MIME de texto plano para acesso simples ao conteúdo

Ferramentas 🧰

  • ✍️ create_note - Cria novas notas de texto
    • 🏷️ Requer título e conteúdo como parâmetros obrigatórios
    • 💾 Armazena a nota no estado do servidor

Prompts 🧠

  • 📝 summarize_notes - Gera um resumo de todas as notas armazenadas
    • 📥 Inclui todos os conteúdos das notas como recursos embutidos
    • 📤 Retorna um prompt estruturado para resumir com LLM

Desenvolvimento 👨‍💻👩‍💻

Instale as dependências:

npm install

Compile o servidor:

npm run build

Inicie o servidor:

npm start

Instalação ⚙️

Para usar com Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-low-level-server-streamable-http": {
      "type": "http",
      "url": "http://localhost:3001/mcp"
    }
  }
}

Depuração 🐞🔍

Como os servidores MCP se comunicam por stdio, depurar pode ser complicado. Recomendamos usar o MCP Inspector 🕵️‍♂️, disponível como script de npm:

npm run inspector

O Inspector fornecerá uma URL 🌐 para acessar ferramentas de depuração no seu navegador.