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