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

Related MCP server: MCP Kibela

🚀 Instalación

Prerrequisitos

• Python 3.10 o superior

• Joplin Desktop con el servicio Web Clipper habilitado

• uv (administrador de paquetes de Python)

# Clone repository
git clone https://github.com/dweigend/joplin-mcp.git
cd joplin-mcp

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
```bash
uv pip install -e .

⚙️ 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:

JOPLIN_TOKEN=your_api_token_here

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:

MCP_LOG_LEVEL=debug mcp dev src/mcp/joplin_mcp.py

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 .