AI Sticky Notes MCP Server

Un servidor MCP que permite a un asistente de IA guardar, leer y resumir notas personales. Las notas se almacenan en un archivo local notes.txt junto al servidor.

Características

• add_note herramienta: Añade una nota nueva.

• read_notes herramienta: Lee todas las notas guardadas.

• notes://latest recurso: Recupera la nota añadida más reciente.

• note_summary_prompt prompt: Crea un prompt que contiene las notas actuales para resumirlas.

Related MCP server: AI Sticky Notes

Requisitos

• Python 3.12 o posterior

• pip o uv

Ejecutar localmente

Usando uv

uv sync
uv run python main.py

Usando pip

Crea y activa un entorno virtual y, a continuación, instala la dependencia:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python main.py

El servidor se comunica mediante MCP stdio, por lo que normalmente lo inicia un cliente compatible con MCP en lugar de abrirse directamente en un navegador.

Probar el servidor

Con la CLI de MCP instalada, inicia MCP Inspector con:

mcp dev main.py

Usa Inspector para llamar a add_note, read_notes, abrir el recurso notes://latest y ejecutar note_summary_prompt.

También puedes verificar directamente el módulo de Python y su sintaxis:

uv run python -c "import main; print('MCP server import ok')"
uv run python -m py_compile main.py

Desplegar con Smithery

El repositorio incluye smithery.yaml, que configura Smithery para iniciar el servidor con:

startCommand:
	type: stdio
	command: python
	args: ["main.py"]

Sube los archivos de despliegue a un repositorio de GitHub y despliega ese repositorio a través de Smithery. Los archivos importantes son:

• main.py

• requirements.txt

• smithery.yaml

notes.txt es opcional porque el servidor lo crea automáticamente cuando es necesario. Inclúyelo solo si quieres distribuir las notas de ejemplo.

Ejecutar con Docker

Construye la imagen incluida y ejecútala:

docker build -t ai-sticky-notes .
docker run --rm -i ai-sticky-notes

Estructura del proyecto

main.py          MCP server implementation
requirements.txt Python dependencies
smithery.yaml    Smithery stdio startup configuration
Dockerfile       Container build configuration
notes.txt        Local note storage, created automatically if absent

Nota de almacenamiento

Las notas se almacenan en un archivo de texto plano. Esto es adecuado para uso local y demostraciones, pero los contenedores alojados pueden no conservar el archivo entre reinicios o nuevas implementaciones. Para un almacenamiento duradero en producción, conviene usar una base de datos externa o un volumen persistente.