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.

Inkdrop MCP 服务器

Inkdrop 本地 HTTP 服务器 API模型上下文协议服务器。

安装

  1. 设置本地 HTTP 服务器
  2. 将服务器配置添加到 Claude Desktop:
    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %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" } } } }

成分

工具

  1. read-note :通过数据库中的 ID 检索笔记的完整内容。
    • 必需输入:
      • noteId :要检索的笔记的 ID。在笔记文档中,它可以作为_id找到。它始终以note:开头。
  2. search-notes :列出包含给定关键字的所有注释。
    • 必需输入:
      • keyword :要搜索的关键字。
    • 注意:结果包含截断的笔记正文(200 个字符)。使用read-note获取完整内容。
    • 支持高级搜索限定符,如book:tag:status:title:等。
  3. list-notes :列出指定笔记本中的所有笔记。
    • 必需输入:
      • bookId :笔记本 ID。它始终以 'book:' 开头。
    • 可选输入:
      • tagIds :要过滤的标签 ID 数组。每个标签 ID 都以 'tag:' 开头。
      • keyword :用于过滤笔记的关键字。
      • sort :排序字段( updatedAtcreatedAttitle )。默认值: updatedAt
      • descending :反转输出顺序。默认值: true
    • 注意:结果包含截断的笔记正文(200 个字符)。使用read-note获取完整内容。
  4. create-note :在数据库中创建新注释。
    • 必需输入:
      • bookId :笔记本 ID。必须以 'book:' 开头,或者为 'trash'。
      • title :笔记标题。
      • body :Markdown 格式的笔记内容。
    • 可选输入:
      • status :笔记状态( noneactiveonHoldcompleteddropped )。
  5. update-note :更新数据库中现有的注释。
    • 必需输入:
      • _id :笔记 ID。必须以 'note:' 开头。
      • _rev :修订 ID(CouchDB MVCC 令牌)。
      • bookId :笔记本 ID。必须以 'book:' 开头,或者为 'trash'。
      • title :笔记标题。
      • body :Markdown 格式的笔记内容。
    • 可选输入:
      • status :笔记状态( noneactiveonHoldcompleteddropped )。
  6. list-notebooks :检索所有笔记本的列表。
  7. list-tags :检索所有标签的列表。

调试

由于 MCP 服务器通过 stdio 运行,调试起来可能颇具挑战性。为了获得最佳调试体验,我们强烈建议使用MCP Inspector

您可以使用以下命令通过npm启动 MCP Inspector:

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

确保环境变量配置正确。

启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 以开始调试。

您还可以使用以下命令查看服务器日志:

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

通过模型上下文协议将 Inkdrop 笔记应用程序与 Claude AI 集成,允许 Claude 在 Inkdrop 数据库中搜索、阅读、创建和更新笔记。

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