墨滴 MCP 服务器

墨滴 MCP 服务器 是为 Inkdrop Local HTTP Server API 提供支持的 Model Context Protocol (MCP) 服务器。

安装指南

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 数组，每个标签均以 tag: 开头。
     • keyword: 用于过滤笔记的关键字。
     • sort: 排序字段（updatedAt、createdAt 或 title）。默认值为 updatedAt。
     • descending: 是否反转输出顺序。默认值为 true。
   • 注意事项：结果将包含截断的笔记内容（最多 200 字符）。如需获取完整内容，请使用 read-note。

4. create-note：在数据库中创建新的笔记。

   • 必填参数：
     • bookId: 笔记本 ID。格式必须为 book: 开头，或指定为 trash。
     • title: 笔记标题。
     • body: 笔记内容（Markdown 格式）。
   • 可选参数：
     • tags: 与笔记相关的标签数组。

5. update-note：更新现有笔记的内容。

   • 必填参数：
     • noteId: 要更新的笔记 ID。
     • title: 新的标题（可留空）。
     • body: 新的内容（Markdown 格式）。
     • tags: 更新后的标签数组。

6. delete-note：删除指定的笔记。

   • 必填参数：
     • noteId: 要删除的笔记 ID。

调试指南

1. 使用 MCP Inspector 工具来监控和调试 MCP 服务器。
2. 运行以下命令启动 MCP 服务：

npx @inkdropapp/mcp-server

3. 监控日志输出，确保服务正常运行：

tail -f package.json