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": "你的本地服务器用户名",
        "INKDROP_LOCAL_PASSWORD": "你的本地服务器密码"
      }
    }
  }
}

组件

工具

1. read-note: 通过 ID 从数据库中检索笔记的完整内容。
   • 必需输入：
     • noteId: 要检索的笔记 ID。可以在笔记文档中找到，以 note: 开头。
2. search-notes: 列出包含给定关键字的所有笔记。
   • 必需输入：
     • keyword: 要搜索的关键字。
   • 注意：结果包括截断的笔记正文（200 个字符）。使用 read-note 获取完整内容。
   • 支持高级搜索限定符，如 book:、tag:、status:、title: 等。
3. list-notes: 列出符合指定条件的所有笔记。
   • 必需输入：
     • bookId: 笔记本 ID。以 'book:' 开头。
   • 可选输入：
     • tagIds: 用于过滤的标签 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）。
     • tags: 分配给笔记的标签 ID 数组。每个必须以 'tag:' 开头。
5. update-note: 更新数据库中的现有笔记。
   • 必需输入：
     • _id: 笔记 ID。必须以 'note:' 开头。
     • _rev: 修订 ID（CouchDB MVCC-token）。
     • bookId: 笔记本 ID。必须以 'book:' 开头或为 'trash'。
     • title: 笔记标题。
     • body: 笔记内容的 Markdown 格式。
   • 可选输入：
     • status: 笔记状态。
     • tags: 分配给笔记的标签 ID 数组。每个必须以 'tag:' 开头。
6. list-notebooks: 检索所有笔记本的列表。
7. read-book: 通过 ID 检索单个笔记本。
   • 必需输入：
     • bookId: 笔记本 ID。必须以 'book:' 开头。
8. list-tags: 检索所有标签的列表。
9. read-tag: 通过 ID 检索单个标签。
   • 必需输入：
     • tagId: 标签 ID。必须以 'tag:' 开头。
10. create-tag: 在数据库中创建新标签。
    • 必需输入：
      • name: 标签名称。
    • 可选输入：
      • color: 标签的颜色类型（default、red、orange、yellow、olive、green、teal、blue、violet、purple、pink、brown、grey、black）。默认：default。
11. update-tag: 更新数据库中的现有标签。
    • 必需输入：
      • _id: 标签 ID。必须以 'tag:' 开头。
      • _rev: 修订 ID（CouchDB MVCC-token）。
      • name: 标签名称。
    • 可选输入：
      • color: 标签的颜色类型。默认：default。

调试

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

你可以通过 npm 使用以下命令启动 MCP Inspector：

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

确保环境变量已正确配置。

启动后，Inspector 将显示一个 URL，你可以在浏览器中访问该 URL 开始调试。

你也可以通过以下命令查看服务器日志：

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