Anyboxmcp

🚀 Anybox MCP 服務器

Anybox MCP 服務器是為適用於 macOS 的書籤管理器 Anybox 打造的一個模型上下文協議（MCP）服務器。藉助該服務器，Claude Desktop 及其他 MCP 客戶端能夠與你的 Anybox 書籤實現交互。

✨ 主要特性

• 🔍 按關鍵詞、標籤、文件夾或收藏狀態搜索書籤
• 🏷️ 列出所有標籤，包含標籤 ID、名稱和書籤數量
• 📁 列出所有文件夾，包含文件夾 ID、名稱和書籤數量
• ➕ 保存新書籤，可設置標籤、文件夾、備註和收藏狀態
• 🔗 與 Claude Desktop 直接集成，實現無縫書籤管理

📦 安裝指南

前提條件

• 已安裝並運行 Anybox 的 macOS 系統
• Python 3.10 或更高版本
• Anybox API 密鑰（獲取方法見下文）

獲取 Anybox API 密鑰

1. 打開 Anybox 應用程序。
2. 前往 偏好設置 → 通用（或 設置 → 通用）。
3. 複製顯示的 API 密鑰。

安裝步驟

1. 克隆或下載本倉庫

cd ~/coding/anyboxTidier

2. 創建虛擬環境並安裝依賴項

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. 設置 API 密鑰 你需要在 Claude Desktop 配置中設置 API 密鑰（見下文），無需全局導出。

💻 使用示例

與 Claude Desktop 配合使用

配置

選項 1：自動設置（推薦） 運行設置腳本，它將引導你完成配置：

./setup_claude_desktop.sh

此腳本將執行以下操作：

• 測試你的 Anybox API 連接
• 自動配置 Claude Desktop
• 驗證一切是否正常工作

選項 2：手動配置

1. 找到你的 Claude Desktop 配置文件：
   • macOS 系統：~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加 MCP 服務器配置：

{
    "mcpServers": {
        "anybox": {
            "command": "/Users/tommertron/coding/anyboxTidier/venv/bin/python",
            "args": [
                "/Users/tommertron/coding/anyboxTidier/anybox_mcp_server.py"
            ],
            "env": {
                "ANYBOX_API_KEY": "your-api-key-here"
            }
        }
    }
}

重要提示：

• 將 /Users/tommertron/coding/anyboxTidier 替換為你克隆此倉庫的實際路徑。
• 將 your-api-key-here 替換為你實際的 Anybox API 密鑰。
• 確保在 venv/bin 目錄中使用 Python 解釋器的完整路徑。

3. 重啟 Claude Desktop

可用工具

配置完成後，Claude 可以使用以下工具：

search_bookmarks

使用各種過濾器搜索書籤。 參數：

• query（可選）：搜索關鍵詞
• tag_id（可選）：按標籤 ID 過濾
• folder_id（可選）：按文件夾 ID 過濾
• starred（可選）："yes" 或 "no"
• limit（可選）：最大結果數（默認值：50） 示例提示：
• "在我的 Anybox 中搜索關於 Python 的書籤"
• "查找所有收藏的書籤"
• "搜索 '工作' 文件夾中的書籤"

list_tags

獲取所有標籤及其 ID 和書籤數量。 示例提示：

• "列出我所有的 Anybox 標籤"
• "我有哪些標籤？"

list_folders

獲取所有文件夾及其 ID 和書籤數量。 示例提示：

• "列出我所有的 Anybox 文件夾"
• "我在 Anybox 中有哪些文件夾？"

save_bookmark

保存帶有可選元數據的新書籤。 參數：

• url（必需）：URL 或筆記內容
• comment（可選）：關於書籤的備註
• tag_ids（可選）：標籤 ID 數組
• folder_id（可選）：文件夾 ID
• starred（可選）：布爾值（默認值：false） 示例提示：
• "將 https://example.com 保存到 Anybox"
• "將此 URL 保存到 Anybox 並添加 '編程' 標籤"
• "將 https://github.com 添加到我 Anybox 中的 '工作' 文件夾"

示例工作流程

以下是與 Claude Desktop 的典型對話示例：

你："列出我所有的 Anybox 標籤"
Claude：[使用 list_tags 工具]
        "你有 15 個標籤。以下是其中一些：編程、設計、研究..."

你："搜索帶有編程標籤的書籤"
Claude：[使用 list_tags 獲取標籤 ID，然後使用 search_bookmarks]
        "找到 23 個帶有編程標籤的書籤：
         1. Python 文檔 - https://docs.python.org
         2. ..."

你："將 https://github.com/anthropics/anthropic-sdk-python 保存到 Anybox 並添加編程標籤"
Claude：[使用 list_tags 獲取標籤 ID，然後使用 save_bookmark]
        "✅ 書籤保存成功！"

📚 詳細文檔

故障排除

連接錯誤

錯誤信息：Connection refused 或 Error searching bookmarks 解決方案：

1. 確保 Anybox 正在運行。
2. 驗證 API 是否在 http://127.0.0.1:6391 上運行。
3. 檢查你的 API 密鑰是否正確。
4. 手動測試連接：

curl -H "x-api-key: YOUR_KEY" http://127.0.0.1:6391/tags

API 密鑰問題

錯誤信息：401 Unauthorized 或 Incorrect API Key 解決方案：

1. 從 Anybox 偏好設置中複製一個新的 API 密鑰。
2. 確保環境變量設置正確。
3. 更新配置後重啟 Claude Desktop。

Python/MCP 問題

錯誤信息：mcp module not found 解決方案：

pip install mcp httpx

錯誤信息：Python 版本不兼容 解決方案：確保安裝了 Python 3.10 或更高版本：

python3 --version

API 參考

此服務器使用運行在 http://127.0.0.1:6391 上的 Anybox 本地 HTTP API。

已發現的端點

• GET /search?q=&tag=&folder=&starred=&limit= - 搜索書籤
• GET /tags - 列出所有標籤
• GET /folders - 列出所有文件夾
• POST /save - 使用 {note, comment, tags[], folder, starred} 保存書籤

身份驗證

所有請求都使用帶有你的 API 密鑰的 x-api-key 標頭。

開發

直接運行服務器

用於測試：

python3 anybox_mcp_server.py

服務器通過標準輸入輸出使用 MCP 協議進行通信。

添加新工具

要添加新功能，請按以下步驟操作：

1. 在 list_tools() 中添加工具定義。
2. 在 call_tool() 中實現處理程序。
3. 將任何新的 API 方法添加到 AnyboxAPI 類中。

📄 許可證

本項目採用 MIT 許可證。有關 Anybox API 文檔來源，請參閱 claude.md。

貢獻說明

歡迎貢獻代碼！如果你發現了額外的 Anybox API 端點或功能，請提交拉取請求。

注意：這是一個非官方集成。Anybox 未提供官方公開的 API 文檔。此服務器基於對 Raycast 擴展和其他社區資源的逆向工程。