Tinderbox MCP

🚀 Tinderbox MCP 服務器

Tinderbox MCP 服務器是一個模型上下文協議（MCP）服務器，它能讓像 Claude 這樣的 AI 助手與強大的 macOS 知識管理應用程序 Tinderbox 進行交互。藉助該服務器，你可以通過自然語言控制 Tinderbox，並將其與助手可訪問的其他服務相連接。

🚀 快速開始

先決條件

• Tinderbox
• Node.js 18 或更高版本
• 一個 MCP 兼容的客戶端（僅在此處使用 Claude Desktop 進行測試）

安裝

1. 克隆此倉庫：

git clone https://github.com/phkus/tinderbox-mcp.git
cd tinderbox-mcp

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

運行服務器

使用以下命令運行服務器：

npm run start

與 Claude Desktop 一起使用

1. 將以下配置添加到 Claude Desktop 的配置文件中：

{
  "Tinderbox MCP Server": {
    "path": "/path/to/tinderbox-mcp-server"
  }
}

2. 啟動服務器後，可以在 Claude Desktop 中選擇 Tinderbox MCP 服務器作為目標。

✨ 主要特性

此服務器涵蓋了一系列 Tinderbox 操作，具體如下：

• create_note - 創建文檔中的新筆記
• link_notes - 在現有筆記之間創建鏈接，可選指定鏈接類型
• update_attributes - 更改指定筆記的屬性值
• read_note - 獲取筆記內容（當前僅返回筆記標題和正文）
• get_siblings - 找到同一層次結構級別的筆記（此工具和其他工具返回筆記路徑及其 ChildCount，以讓助手瞭解可以進一步探索的地方）
• get_children - 獲取指定父筆記的所有子筆記
• get_links - 查找某條筆記的所有出站鏈接

所有這些操作都需要模型知道要使用的文檔。默認文檔名為 Playground，這是開發者自己的測試文檔。其他默認值可以在腳本配置中找到，在 /src/index.ts。

⚠️ 注意事項

⚠️ 重要提示

update_attribute 工具可能會覆蓋或刪除現有數據，請確保定期備份您的文檔。

💡 擴展建議

• 將 Tinderbox MCP 服務器與其他知識管理系統集成
• 添加對 DEVONthink 和 Bookends 的支持
• 實現更復雜的查詢功能，如搜索和過濾

🙏 致謝

感謝 Josh Rutkowski 的啟發性工作。此項目的主要區別在於，applescript - mcp 將完整的腳本內容傳遞到終端，而這個實現調用單獨的腳本文件。

感謝 Mark Bernstein，Tinderbox 的開發者，感謝他開發了這個可腳本化應用程序。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎在此項目中進行貢獻或通過在 Tinderbox 論壇上發送反饋（用戶名：pkus）提供反饋。