JinDaGe - maccy-clipboard-mcp MCP Details

article

README

🚀 Maccy剪贴板MCP服务器

Maccy剪贴板MCP服务器是一个基于MCP（模型上下文协议）的服务器，它可以将你的Maccy剪贴板历史记录提供给Claude等AI助手，方便你通过自然对话搜索、检索和管理复制的内容。

⚠️ 重要安全警告

⚠️ 重要提示

此工具会让Claude访问你的整个剪贴板历史记录，其中可能包含敏感信息，如密码、API密钥、个人数据或机密内容。当连接到外部AI系统时，这些数据可能会传输到本地机器之外。使用此MCP服务器即表示你承认并承担因数据暴露或安全风险而产生的全部责任。作者对因使用此工具可能导致的任何未经授权的访问、数据泄露或安全漏洞不承担任何责任。请自行承担使用风险，在安装前仔细考虑你的安全需求。

✨ 主要特性

🔍 通过文本模式搜索剪贴板历史记录
📋 获取包含完整内容的最近剪贴板项目
🖼️ 支持图像 - 查看剪贴板历史记录中的图像
📌 固定/取消固定重要项目
📊 查看剪贴板使用统计信息
🗂️ 按应用程序过滤
📁 将历史记录导出为JSON/CSV/TXT格式

📦 安装指南

简易安装（推荐）

从本仓库下载 maccy-clipboard-mcp.dxt 文件。
双击 .dxt 文件，在Claude Desktop中打开。
Claude Desktop将自动安装并配置MCP服务器。
重启Claude Desktop。

手动安装

如果你在使用 .dxt 文件安装时遇到问题，可以按照以下步骤手动安装：

克隆本仓库：

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

安装依赖项：

npm install

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

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

重启Claude Desktop。

故障排除

如果你在加载扩展或遇到Node.js相关问题时，可以参考以下解决方案：

必需的Node.js配置（如果出现问题）

⚠️ 重要提示

如果扩展加载失败，请尝试禁用Claude Desktop内置的Node.js。

安装Node.js LTS：访问 nodejs.org 并下载LTS版本。
配置Claude Desktop：
- 转到Claude > 设置 > 扩展 > 高级设置。
- 禁用 “使用内置Node.js进行MCP”。
- 重启Claude Desktop。

有些用户可能需要使用系统安装的Node.js，而不是Claude的内置版本。

其他故障排除步骤

如果你仍然遇到问题，请按照以下步骤操作：

验证Node.js是否已安装：在终端中运行 node --version。
确保在Claude Desktop设置中禁用了 “使用内置Node.js进行MCP”。
完全重启Claude Desktop。
查看日志文件（macOS：~/Library/Logs/Claude/；Windows：%LOCALAPPDATA%\Claude\Logs\）以获取MCP服务器错误详情。

💻 使用示例

可用工具

search_clipboard - 通过文本模式和过滤器进行搜索
get_recent_items - 获取支持图像的最近项目（默认显示图像）
copy_to_clipboard - 将项目复制回剪贴板（支持文本和图像）
pin_item / unpin_item - 管理固定项目
export_history - 导出到本地文件
get_clipboard_stats - 查看使用统计信息
get_items_by_app - 通过应用程序过滤并支持图像

📚 详细文档

关于Maccy

Maccy 是一款适用于macOS的轻量级剪贴板管理器，它会记录你复制的所有内容。它在菜单栏中运行，并将剪贴板项目本地存储在SQLite数据库中。此MCP服务器直接连接到该数据库，使Claude能够访问你的剪贴板历史记录，让你可以通过自然对话搜索、检索和管理复制的内容。

图像支持

服务器会自动检测并返回剪贴板历史记录中的图像：

在最近项目和搜索结果中默认显示图像。
图像以Base64编码数据形式返回，并带有缩略图（宽度为100px）。
支持PNG、JPEG、TIFF等常见格式。
图像会用 🖼️ 标记。
文本和图像内容都可以复制回剪贴板。

注意事项

所有数据都保留在本地机器上。
服务器默认只有只读访问权限（固定/取消固定操作除外）。
大型导出文件会写入本地文件，以避免MCP大小限制。

maccy-clipboard-mcp