Inkdrop

🚀 墨滴 MCP 服务器

墨滴 MCP 服务器是为 Inkdrop Local HTTP Server API 提供支持的 Model Context Protocol (MCP) 服务器，它能助力相关应用更好地实现数据交互与管理。

🚀 快速开始

墨滴 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 数组，每个标签均以 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