README.md
A TypeScript-based MCP server that implements a simple note-taking system.
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.
Tools (1)
create_noteCreates a new text note and stores it in the server state.Configuration
claude_desktop_config.json
{"mcpServers": {"mcp-low-level-server-streamable-http": {"type": "http", "url": "http://localhost:3001/mcp"}}}Try it
→Create a new note titled 'Meeting Notes' with the content 'Discussed project timeline and budget.'
→Summarize all my stored notes.
→List all available notes using the note:// URI scheme.