0gis0 MCP

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.