MCP服务器

Inkdrop MCP Server

适用于 Inkdrop Local HTTP Server API 的 Model Context Protocol 服务器。

<a href="https://glama.ai/mcp/servers/c7fgtnckbv"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1133490286,3038451629&fm=3081&app=3_081&f=PNG?w=760&h=400" alt="Inkdrop Server MCP server" /> </a>

安装

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格式。
   • 可选输入：
     • 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: 笔记状态（none, active, onHold, completed, dropped）。
     • 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服务器通过标准输入输出运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈建议使用 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