Notes MCP Server

Servidor de notas MCP

Esta es una implementación de servidor MCP (Protocolo de Contexto de Modelo) que gestiona notas de Markdown en un directorio determinado. El servidor permite crear, leer y actualizar notas de Markdown mediante el transporte stdio.

Características

• Crear nuevas notas de rebajas
• Leer notas de rebajas existentes
• Actualizar notas de rebajas existentes
• Listar todas las notas en la bóveda
• Gestión automática de archivos en el directorio especificado
• Manejo y registro de errores adecuados
• Seguimiento de marcas de tiempo para la creación y modificación de notas
• Validación del esquema JSON para todas las operaciones

Capacidades del servidor

El servidor implementa las siguientes capacidades:

• Versión: 1.0.0
• Nombre: Servidor MCP de Notes
• Descripción: Un servidor para administrar notas de Markdown en un directorio determinado
• Transportes compatibles: stdio

Recursos

El servidor proporciona el siguiente recurso:

• Propiedades:
  • path : El camino a la bóveda
  • note_count : El número total de notas en la bóveda

Herramientas

El servidor implementa las siguientes herramientas MCP:

crear_nota

Crea una nueva nota de Markdown.

Parámetros:

• title : El título de la nota (obligatorio)
• content : El contenido de la nota (opcional, el valor predeterminado es una cadena vacía)

Devoluciones:

• filename : El nombre del archivo creado
• path : La ruta completa al archivo creado
• created_at : marca de tiempo ISO de creación

leer_nota

Lee una nota de Markdown existente.

Parámetros:

• title : El título de la nota a leer (obligatorio)

Devoluciones:

• title : El título de la nota
• content : El contenido de la nota
• path : La ruta completa al archivo
• created_at : marca de tiempo ISO de creación
• modified_at : marca de tiempo ISO de la última modificación

nota de actualización

Actualiza una nota de Markdown existente.

Parámetros:

• title : El título de la nota a actualizar (obligatorio)
• content : El nuevo contenido de la nota (opcional, el valor predeterminado es una cadena vacía)

Devoluciones:

• filename : El nombre del archivo actualizado
• path : La ruta completa al archivo
• updated_at : marca de tiempo ISO de la actualización

notas de lista

Enumera todas las notas de rebajas en la bóveda.

Parámetros: Ninguno

Devoluciones:

• notes : Matriz de objetos de nota, cada uno de los cuales contiene:
  • title : El título de la nota
  • path : La ruta completa al archivo
  • created_at : marca de tiempo ISO de creación
  • modified_at : marca de tiempo ISO de la última modificación
• total : Número total de notas

Configuración

1. Instale las dependencias necesarias:

2. Configure el servidor para que funcione dentro del directorio indicado en la línea 110 de main.py editando la propiedad notes_dir:
3. Configurar Cursor para utilizar el servidor MCP:
   • El archivo de configuración se encuentra en .cursor/mcp.json
   • El cursor detectará y utilizará automáticamente esta configuración
   • El servidor está configurado para ejecutarse con Python y la codificación UTF-8 adecuada

Ejecución del servidor

El servidor se iniciará automáticamente cuando Cursor cargue el proyecto. También puedes ejecutarlo manualmente:

El servidor se iniciará y escuchará las solicitudes MCP mediante la entrada estándar y la salida estándar. Todas las operaciones se registran con los niveles adecuados (información/error) para su depuración y supervisión.

Manejo de errores

El servidor implementa el manejo de errores adecuado para diversos escenarios:

• Faltan parámetros requeridos
• El archivo ya existe
• Archivo no encontrado
• Excepciones generales

Todos los errores se registran y se devuelven con los códigos de error y mensajes apropiados.

Detalles de configuración

El servidor MCP está configurado en .cursor/mcp.json con las siguientes configuraciones:

Para agregar el MCP como usado globalmente, agréguelo a la carpeta .cursor en su directorio de usuario, o vaya a Configuración del cursor -> MCP -> Agregar nuevo servidor MCP global -> copie/pegue el mcp.json en este proyecto al nuevo archivo -> Actualice los argumentos para que apunten a main.py

Esta configuración:

• Nombra el servidor "notes-server"
• Utiliza Python para ejecutar el servidor.
• Establece la codificación UTF-8 para un manejo adecuado de caracteres