Inkdrop MCP Server

Official

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for interacting with the Inkdrop note-taking application, enabling searching notes, reading note contents, creating new notes, updating existing notes, and listing notebooks.

  • Supports working with Markdown content through Inkdrop, allowing creation and modification of notes with Markdown formatting.

Servidor MCP de Inkdrop

Un servidor de protocolo de contexto de modelo para la API del servidor HTTP local de Inkdrop .

Instalación

  1. Configurar un servidor HTTP local
  2. Agregar configuración de servidor a Claude Desktop:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "inkdrop": { "command": "npx", "args": ["-y", "@inkdropapp/mcp-server"], "env": { "INKDROP_LOCAL_SERVER_URL": "http://localhost:19840", "INKDROP_LOCAL_USERNAME": "your-local-server-username", "INKDROP_LOCAL_PASSWORD": "your-local-server-password" } } } }

Componentes

Herramientas

  1. read-note : recupera el contenido completo de la nota por su ID de la base de datos.
    • Entradas requeridas:
      • noteId : El ID de la nota que se recuperará. Se encuentra como _id en la documentación de la nota. Siempre empieza por note:
  2. search-notes : enumera todas las notas que contienen una palabra clave determinada.
    • Entradas requeridas:
      • keyword : Palabra clave a buscar.
    • Nota: Los resultados incluyen textos truncados (200 caracteres). Use read-note para ver el contenido completo.
    • Admite calificadores de búsqueda avanzados como book: , tag: , status: , title: , etc.
  3. list-notes : enumera todas las notas en un cuaderno específico.
    • Entradas requeridas:
      • bookId : ID del cuaderno. Siempre empieza por 'book:'.
    • Entradas opcionales:
      • tagIds : Una matriz de identificadores de etiquetas para filtrar. Cada uno empieza por 'tag:'.
      • keyword : Palabra clave para filtrar notas.
      • sort : Ordena el campo ( updatedAt , createdAt o title ). Predeterminado: updatedAt .
      • descending : Invierte el orden de salida. Predeterminado: true .
    • Nota: Los resultados incluyen textos truncados (200 caracteres). Use read-note para ver el contenido completo.
  4. create-note : Crea una nueva nota en la base de datos.
    • Entradas requeridas:
      • bookId : ID del cuaderno. Debe empezar por "book:" o ser "trash".
      • title : El título de la nota.
      • body : El contenido de la nota en Markdown.
    • Entradas opcionales:
      • status : el estado de la nota ( none , active , onHold , completed , dropped ).
  5. update-note : actualiza una nota existente en la base de datos.
    • Entradas requeridas:
      • _id : ID de la nota. Debe empezar con 'note:'.
      • _rev : El ID de revisión (token MVCC de CouchDB).
      • bookId : ID del cuaderno. Debe empezar por "book:" o ser "trash".
      • title : El título de la nota.
      • body : El contenido de la nota en Markdown.
    • Entradas opcionales:
      • status : el estado de la nota ( none , active , onHold , completed , dropped ).
  6. list-notebooks : recupera una lista de todos los cuadernos.
  7. list-tags : recupera una lista de todas las etiquetas.

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector "./dist/index.js"

Asegúrese de que las variables de entorno estén configuradas correctamente.

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

También puedes ver los registros del servidor con este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-inkdrop.log

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Integra la aplicación de toma de notas Inkdrop con Claude AI a través del Protocolo de Contexto de Modelo, lo que permite a Claude buscar, leer, crear y actualizar notas en su base de datos Inkdrop.

  1. Installation
    1. Components
      1. Tools
    2. Debugging
      ID: c7fgtnckbv