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í]