local-only server

The server can only run on the client’s local machine because it depends on local resources.

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 :

npx -y @smithery/cli install notes --client claude

Instalación manual

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

Estructura del proyecto

notes/
├── __init__.py          # Package initialization
├── server.py           # Main server implementation
├── storage.py          # Note persistence layer
├── resources.py        # Resource handling (note:// URIs)
├── prompts.py         # LLM prompt generation
└── tools/             # Server tools
    ├── __init__.py    # Tools package initialization
    ├── list_tools.py  # Tool listing functionality
    └── handle_tools.py # Tool handling implementation

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

Iniciar el servidor:
mcp install src/notes mcp start Notes
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:

{
    "note_name": {
        "content": "Note content",
        "created_at": "2025-01-12T11:28:16.721704",
        "modified_at": "2025-01-12T11:28:16.721704"
    }
}

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:

Clonar el repositorio
Instalar dependencias de desarrollo
Realizar cambios en el módulo apropiado
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í]

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Un servidor MCP para administrar y conservar notas, que ofrece operaciones CRUD, resumen de notas y acceso basado en recursos a través de un esquema URI note://.

Related Resources

Reddit Discussion about this server

MCP Notes Server