Inkdrop MCP Server

Inkdrop MCP 服务器

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

Related MCP server: SketchupMCP

安装

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 ：排序字段（ updatedAt 、 createdAt或title ）。默认值： updatedAt 。

     • descending ：反转输出顺序。默认值： true 。

   • 注意：结果包含截断的笔记正文（200 个字符）。使用read-note获取完整内容。

4. create-note ：在数据库中创建新注释。

   • 必需输入：

     • bookId ：笔记本 ID。必须以 'book:' 开头，或者为 'trash'。

     • title ：笔记标题。

     • body ：Markdown 格式的笔记内容。

   • 可选输入：

     • status ：笔记状态（ none 、 active 、 onHold 、 completed 、 dropped ）。

5. update-note ：更新数据库中现有的注释。

   • 必需输入：

     • _id ：笔记 ID。必须以 'note:' 开头。

     • _rev ：修订 ID（CouchDB MVCC 令牌）。

     • bookId ：笔记本 ID。必须以 'book:' 开头，或者为 'trash'。

     • title ：笔记标题。

     • body ：Markdown 格式的笔记内容。

   • 可选输入：

     • status ：笔记状态（ none 、 active 、 onHold 、 completed 、 dropped ）。

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