MCP Low-Level Server Streamable HTTP

A low-level MCP server implementation with streamable HTTP support, configured via environment variables.

GitHub

Cómo crear un servidor MCP usando Low-Level Server y Streameable HTTP 🚀🖥️✨

Este es un servidor MCP basado en TypeScript que implementa un sistema sencillo de notas. Demuestra conceptos clave de MCP proporcionando:

  • 📄 Recursos que representan notas de texto con URIs y metadatos
  • 🛠️ Herramientas para crear nuevas notas
  • 💡 Prompts para generar resúmenes de notas

Características 🌟

Recursos 📚

  • 📑 Lista y accede a notas mediante URIs note://
  • 🏷️ Cada nota tiene título, contenido y metadatos
  • 📝 Tipo MIME de texto plano para acceso sencillo al contenido

Herramientas 🧰

  • ✍️ create_note - Crea nuevas notas de texto
    • 🏷️ Requiere título y contenido como parámetros obligatorios
    • 💾 Almacena la nota en el estado del servidor

Prompts 🧠

  • 📝 summarize_notes - Genera un resumen de todas las notas almacenadas
    • 📥 Incluye todos los contenidos de las notas como recursos embebidos
    • 📤 Devuelve un prompt estructurado para la resumir con LLM

Desarrollo 👨‍💻👩‍💻

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Inicia el servidor:

npm start

Instalación ⚙️

Para usar con Claude Desktop, añade la configuración del servidor:

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

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

Debugging 🐞🔍

Como los servidores MCP se comunican por stdio, depurar puede ser complicado. Recomendamos usar el MCP Inspector 🕵️‍♂️, disponible como script de npm:

npm run inspector

El Inspector te dará una URL 🌐 para acceder a herramientas de depuración en tu navegador.

Related Servers