MCP Notes Server

Servidor de notas MCP

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para administrar notas con almacenamiento persistente.

Características

• Crear, leer, actualizar y eliminar notas
• Almacenamiento persistente mediante JSON
• Seguimiento de marcas de tiempo para creación y modificaciones
• Resumen de notas mediante indicaciones
• Acceso basado en recursos mediante el esquema URI note://

Instalación

Instalación mediante herrería

Para instalar notas para Claude Desktop automáticamente a través de Smithery :

Instalación manual

1. Asegúrese de tener instalado Python 3.10 o posterior
2. Crear un entorno virtual:
   python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Requisitos de instalación:
   pip install MCP

Estructura del proyecto

Herramientas disponibles

• add-note : Crea una nueva nota
• list-all-notes : Muestra todas las notas almacenadas
• update-note : Modificar una nota existente
• delete-note : Eliminar una nota

Uso

1. Iniciar el servidor:
   mcp install src/notes mcp start Notes
2. Operaciones de ejemplo:
   # Create a note await client.call_tool("add-note", { "name": "example", "content": "This is a test note" }) # List all notes await client.call_tool("list-all-notes") # Update a note await client.call_tool("update-note", { "name": "example", "content": "Updated content" }) # Delete a note await client.call_tool("delete-note", { "name": "example" })

Almacenamiento

Las notas se almacenan en notes_storage.json con la siguiente estructura:

Acceso a recursos

Se puede acceder a las notas como recursos utilizando el esquema URI note:// :

• Lista de recursos: devuelve todas las notas disponibles como recursos
• Leer recurso: Acceder a una nota específica usando note://internal/note_name

Generación de indicaciones

El servidor incluye una función de generación de indicaciones para resumir notas:

• Admite resúmenes breves y detallados
• Notas de formato para la entrada del modelo de lenguaje
• Disponible a través del mensaje "resumir notas"

Desarrollo

Para modificar o ampliar el servidor:

1. Clonar el repositorio
2. Instalar dependencias de desarrollo
3. Realizar cambios en el módulo apropiado
4. Pruebe exhaustivamente antes de implementar

Pruebas

Las pruebas deben cubrir:

• Operaciones CRUD básicas
• Manejo de múltiples notas
• Casos de error
• Acceso a recursos
• Generación de mensajes rápidos

Licencia

[Agregue su licencia aquí]