Inkdropapp_mcp Server

Inkdrop MCP 服务器

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

<a href="https://glama.ai/mcp/servers/c7fgtnckbv"> <img width="380" height="200" src="https://glama.ai/mcp/servers/c7fgtnckbv/badge" 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)。
5. update-note: 更新数据库中现有的笔记。
   • 必需输入：
     • _id: 笔记 ID。必须以 'note:' 开头。
     • _rev: 修订 ID (CouchDB MVCC-token)。
     • 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"

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

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

您还可以使用以下命令查看服务器日志：

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