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

Related MCP server: pdf-reader-server

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:

pip install -r requirements.txt

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:

python main.py

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:

{
  "mcpServers": {
    "notes-server": {
      "command": "python",
      "args": ["main.py"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

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