Servidor MCP de Joplin

Un servidor de Protocolo de Contexto de Modelo (MCP) para Joplin que permite el acceso a notas mediante dicho protocolo . Ideal para la integración con asistentes de IA como Claude.

✨ Características

• 🔍 Buscar notas : Búsqueda de texto completo en todas las notas
• 📖 Leer notas : recuperar notas individuales
• ✏️ Editar notas : crea nuevas notas y actualiza las existentes
• 🗑️ Eliminar notas : Mueva notas a la papelera o elimínelas permanentemente
• 📥 Importación de Markdown : Importa archivos de Markdown como notas
• 🤖 Integración con IA : Integración perfecta con Claude y otros asistentes de IA compatibles con MCP

🚀 Instalación

Prerrequisitos

• Python 3.10 o superior
• Joplin Desktop con el servicio Web Clipper habilitado
• uv (administrador de paquetes de Python)

⚙️ Configuración

Token de API de Joplin

1. Abra Joplin Desktop
2. Vaya a Herramientas -> Opciones -> Web Clipper
3. Habilitar el servicio Web Clipper
4. Copiar el token de API

Cree un archivo .env en el directorio del proyecto:

Configuración del escritorio de Claude

1. Instalar Claude Desktop
   • Descargar Claude Desktop
   • Asegúrate de tener la última versión (Menú: Claude -> Buscar actualizaciones...)
2. Configurar el servidor MCP
   { "mcpServers": { "joplin": { "command": "/PATH/TO/UV/uv", "args": [ "--directory", "/PATH/TO/YOUR/PROJECT/joplin_mcp", "run", "src/mcp/joplin_mcp.py" ] } } }
   • Reemplace /PATH/TO/UV/uv con la ruta absoluta a su instalación de uv
     • Encuentra el camino con: which uv
     • Ejemplo macOS: /Users/username/.local/bin/uv
     • Ejemplo de Windows: C:\Users\username\AppData\Local\Microsoft\WindowsApps\uv.exe
   • Reemplace /PATH/TO/YOUR/PROJECT/joplin_mcp con la ruta absoluta a su proyecto

   Importante : Claude Desktop necesita la ruta completa a uv ya que no puede acceder a las variables de entorno del shell.

🛠️ Herramientas disponibles

notas de búsqueda

Buscar notas en Joplin.

Parámetros:

• query (cadena): consulta de búsqueda
• limit (int, opcional): número máximo de resultados (predeterminado: 100)

obtener_nota

Recuperar una nota específica por su ID.

Parámetros:

• note_id (cadena): ID de la nota

crear_nota

Crear una nueva nota.

Parámetros:

• title (cadena): Título de la nota
• body (cadena, opcional): contenido de la nota en Markdown
• parent_id (cadena, opcional): ID de la carpeta principal
• is_todo (booleano, opcional): si se trata de un elemento de tarea pendiente

nota de actualización

Actualizar una nota existente.

Parámetros:

• note_id (cadena): ID de la nota a actualizar
• title (cadena, opcional): Nuevo título
• body (cadena, opcional): Nuevo contenido
• parent_id (cadena, opcional): ID de la nueva carpeta principal
• is_todo (booleano, opcional): Nuevo estado de la tarea pendiente

eliminar_nota

Eliminar una nota.

Parámetros:

• note_id (cadena): ID de la nota a eliminar
• permanent (booleano, opcional): si es verdadero, elimina permanentemente la nota

importación_markdown

Importar un archivo Markdown como una nueva nota.

Parámetros:

• file_path (cadena): Ruta al archivo Markdown

🧪 Desarrollo

Modo de depuración

Para iniciar el servidor en modo de depuración:

Esto inicia el Inspector MCP en http://localhost:5173 donde puedes probar las herramientas.

📄 Licencia

Licencia MIT - Copyright (c) 2025 David Weigend

👤 Autor

David Weigend

• Sitio web: weigend.studio
• GitHub: @dweigend

🤝 Contribuyendo

¡Agradecemos sus contribuciones, problemas y solicitudes de funciones! Visite la página de problemas .