Maccy Clipboard MCP

🚀 Maccy剪貼板MCP服務器

Maccy剪貼板MCP服務器是一個基於MCP（模型上下文協議）的服務器，它可以將你的Maccy剪貼板歷史記錄提供給Claude等AI助手，方便你通過自然對話搜索、檢索和管理複製的內容。

⚠️ 重要安全警告

⚠️ 重要提示

此工具會讓Claude訪問你的整個剪貼板歷史記錄，其中可能包含敏感信息，如密碼、API密鑰、個人數據或機密內容。當連接到外部AI系統時，這些數據可能會傳輸到本地機器之外。使用此MCP服務器即表示你承認並承擔因數據暴露或安全風險而產生的全部責任。作者對因使用此工具可能導致的任何未經授權的訪問、數據洩露或安全漏洞不承擔任何責任。請自行承擔使用風險，在安裝前仔細考慮你的安全需求。

✨ 主要特性

• 🔍 通過文本模式搜索剪貼板歷史記錄
• 📋 獲取包含完整內容的最近剪貼板項目
• 🖼️ 支持圖像 - 查看剪貼板歷史記錄中的圖像
• 📌 固定/取消固定重要項目
• 📊 查看剪貼板使用統計信息
• 🗂️ 按應用程序過濾
• 📁 將歷史記錄導出為JSON/CSV/TXT格式

📦 安裝指南

簡易安裝（推薦）

1. 從本倉庫下載 maccy-clipboard-mcp.dxt 文件。
2. 雙擊 .dxt 文件，在Claude Desktop中打開。
3. Claude Desktop將自動安裝並配置MCP服務器。
4. 重啟Claude Desktop。

手動安裝

如果你在使用 .dxt 文件安裝時遇到問題，可以按照以下步驟手動安裝：

1. 克隆本倉庫：

git clone <repository-url>
cd maccy-clipboard-mcp

2. 安裝依賴項：

npm install

3. 將以下內容添加到Claude Desktop配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "maccy-clipboard": {
      "command": "node",
      "args": ["/path/to/maccy-clipboard-mcp/server/index.js"]
    }
  }
}

4. 重啟Claude Desktop。

故障排除

如果你在加載擴展或遇到Node.js相關問題時，可以參考以下解決方案：

必需的Node.js配置（如果出現問題）

⚠️ 重要提示

如果擴展加載失敗，請嘗試禁用Claude Desktop內置的Node.js。

1. 安裝Node.js LTS：訪問 nodejs.org 並下載LTS版本。
2. 配置Claude Desktop：
   • 轉到Claude > 設置 > 擴展 > 高級設置。
   • 禁用 “使用內置Node.js進行MCP”。
   • 重啟Claude Desktop。

有些用戶可能需要使用系統安裝的Node.js，而不是Claude的內置版本。

其他故障排除步驟

如果你仍然遇到問題，請按照以下步驟操作：

1. 驗證Node.js是否已安裝：在終端中運行 node --version。
2. 確保在Claude Desktop設置中禁用了 “使用內置Node.js進行MCP”。
3. 完全重啟Claude Desktop。
4. 查看日誌文件（macOS：~/Library/Logs/Claude/；Windows：%LOCALAPPDATA%\Claude\Logs\）以獲取MCP服務器錯誤詳情。

💻 使用示例

可用工具

1. search_clipboard - 通過文本模式和過濾器進行搜索
2. get_recent_items - 獲取支持圖像的最近項目（默認顯示圖像）
3. copy_to_clipboard - 將項目複製回剪貼板（支持文本和圖像）
4. pin_item / unpin_item - 管理固定項目
5. export_history - 導出到本地文件
6. get_clipboard_stats - 查看使用統計信息
7. get_items_by_app - 通過應用程序過濾並支持圖像

📚 詳細文檔

關於Maccy

Maccy 是一款適用於macOS的輕量級剪貼板管理器，它會記錄你複製的所有內容。它在菜單欄中運行，並將剪貼板項目本地存儲在SQLite數據庫中。此MCP服務器直接連接到該數據庫，使Claude能夠訪問你的剪貼板歷史記錄，讓你可以通過自然對話搜索、檢索和管理複製的內容。

圖像支持

服務器會自動檢測並返回剪貼板歷史記錄中的圖像：

• 在最近項目和搜索結果中默認顯示圖像。
• 圖像以Base64編碼數據形式返回，並帶有縮略圖（寬度為100px）。
• 支持PNG、JPEG、TIFF等常見格式。
• 圖像會用 🖼️ 標記。
• 文本和圖像內容都可以複製回剪貼板。

注意事項

• 所有數據都保留在本地機器上。
• 服務器默認只有只讀訪問權限（固定/取消固定操作除外）。
• 大型導出文件會寫入本地文件，以避免MCP大小限制。