Skip to main content
Glama
0GiS0

mcp-low-level-server-streamable-http

by 0GiS0
README.md
# 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:

```bash
npm install
```

Compila el servidor:

```bash
npm run build
```

Inicia el servidor:

```bash
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`

```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](https://github.com/modelcontextprotocol/inspector) 🕵️‍♂️, disponible como script de npm:

```bash
npm run inspector
```

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