Inkdropapp MCP Server

🚀 墨滴 MCP 服務器

墨滴 MCP 服務器是專為 Inkdrop Local HTTP Server API 設計的 Model Context Protocol 服務器，為用戶提供便捷的數據訪問與管理服務。

🚀 快速開始

安裝步驟

1. 設置本地 HTTP 服務器
2. 將服務器配置添加到 Claude 桌面：
   • 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，可在筆記文檔中找到，始終以 note: 開頭。
2. search-notes：列出包含給定關鍵詞的所有筆記。
   • 必要輸入：
     • keyword：要搜索的關鍵詞。
   • 備註：結果包含截斷的筆記正文（最多 200 字符），可使用 read-note 獲取完整內容。支持高級搜索限定符，如 book:、tag:、status:、title: 等。
3. list-notes：在指定筆記本中列出所有筆記。
   • 必要輸入：
     • bookId：筆記本 ID，必須以 book: 開頭或為 trash。
   • 可選輸入：
     • 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：版本控制令牌（CouchDB MVCC 標識符）。
     • bookId：筆記本 ID，必須以 book: 開頭或為 trash。
     • title：筆記標題。
     • body：筆記內容的 Markdown 格式。
   • 可選輸入：
     • status：筆記狀態（none、active、onHold、completed、dropped）。
6. list-notebooks：檢索所有筆記本的列表。
7. list-tags：檢索所有標籤的列表。

🔧 技術細節

調試說明

由於 MCP 服務器通過標準輸入輸出運行，調試可能具有挑戰性。為了獲得最佳調試體驗，我們強烈推薦使用 MCP 檢查器。

您可以通過以下命令使用 npm 啟動檢查器：

npx @modelcontextprotocol/inspector

將 http://localhost:19840 複製並粘貼到檢查器的 URL 字段中，然後點擊 Connect。

檢查器將顯示有關正在運行的 MCP 服務器的詳細信息，並提供交互式界面來測試和調試工具。

📚 詳細文檔

完整的 API 文檔可以在 GitHub 上找到。

📄 許可證

文檔未提及許可證相關信息。

👥 貢獻者

• [your GitHub username]

感謝您使用 Inkdrop 的 MCP 服務器！