Inkdrop

🚀 墨滴 MCP 服務器

墨滴 MCP 服務器是為 Inkdrop Local HTTP Server API 提供支持的 Model Context Protocol (MCP) 服務器，它能助力相關應用更好地訪問和處理數據。

🚀 快速開始

要使用墨滴 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