剪贴板管理器

MCP剪贴板管理器

给你的AI代理一个记忆 -永远不要再失去背景！ 🚀

将持久剪贴板功能添加到Claude Desktop、VS Code或任何兼容MCP的AI代理的最简单方法。

🎯 这有什么作用

问题：AI代理在对话之间会忘记一切。那个有用的代码片段或错误消息？跑了。

解决方案：这为您的AI提供了一个持久的、可搜索的剪贴板，可以记住会话中的所有内容。

⚡ 一键安装

选项1:Docker（推荐-无需安装）

只需将此添加到MCP客户端配置中并重新启动：

{
  "mcpServers": {
    "clipboard": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-v", "mcp-clipboard-data:/app/data",
        "-e", "DOCKER_CONTAINER=true",
        "ghcr.io/erik-balfe/mcp-clipboard:latest"
      ]
    }
  }
}

选项2：直接安装（需要Bun）

1. 安装Bun: curl -fsSL https://bun.sh/install | bash
2. 添加到配置:

{
  "mcpServers": {
    "clipboard": {
      "command": "npx",
      "args": ["@tyr/mcp-clipboard@latest"]
    }
  }
}

📁 配置放在哪里

✅ 就是这样！

重启你的AI客户端，你就完成了。您的AI现在可以：

• 记住 代码片段、错误消息和注释
• 搜索 通过它所拯救的一切
• 视图 您复制的图像和文件
• 针 要永远保存的重要物品

🎪 你的AI现在能做什么

💬 示例用法

You: "Save this error for debugging later"
AI: I'll save that error message to the clipboard.

[Later conversation]
You: "What was that database error from earlier?"
AI: Let me search the clipboard... Found it! Here's the error:

🔒 隐私和安全

• 100%本地：一切都在你的机器上
• 没有网络：完全离线操作
• 安全：内置路径验证和速率限制
• 专用模式：敏感内容自动过期

💡 常见用例

💻 对于开发者

• 保存错误消息，并要求AI稍后进行调试
• 在对话中保留有用的代码片段
• 固定常用命令和引用
• 借助人工智能帮助构建可搜索的知识库

📚 用于研究

• 阅读时保存引文和参考文献
• 要求AI综合多个剪辑中的信息
• 跟踪重要来源和数据
• 在不同研究线程之间建立联系

✍️ 用于内容创建

• 保存草稿版本并获取AI反馈
• 比较你作品的不同版本
• 保持灵感和想法的条理化
• 让AI帮助您完善和改进内容

🔧 设置

• 存储：所有内容都保存在Docker卷中 mcp-clipboard-data （持续）
• 限制：最多50个项目（固定项目不计算在内）
• 文件大小：每个文件高达100MB
• 搜索：对所有内容进行全文搜索
• 持久性：数据在容器重启后仍然存在

🚨 需要帮助？

快速修复

Docker不工作？

• 确保Docker已安装并正在运行
• 请尝试直接安装选项

AI看不到剪贴板工具？

• 添加配置后重新启动AI客户端
• 检查配置文件是否为有效的JSON

权限错误？

• 确保配置文件位置可写
• 使用绝对路径（如 /Users/username)而不是 ~ 或 ${HOME}
• 确保装载的目录存在并且可读

还有问题吗？

1. 检查日志 在您的AI客户端中显示错误消息
2. 手动测试: docker run ghcr.io/erik-balfe/mcp-clipboard:latest
3. 提交错误报告 在…上 GitHub问题

🎉 就是这样！

你的AI代理现在有了持久内存。它可以记住对话，随着时间的推移积累知识，并帮助你更有效地前进。

问题？ 打开一个问题 我们会帮你设置。

git clone https://github.com/erik-balfe/mcp-clipboard.git
cd mcp-clipboard
bun install
bun run dev

📜 许可证

麻省理工学院许可证-可自由使用！