Pastea

Pastea MCP

适用于 Pastea 的本地 MCP 服务。 让 Claude、Cursor、Codex、VS Code 和 其他 AI 工具访问 Mac 的剪贴板历史记录——所有数据都不会离开 Mac。

你的助手可以搜索复制过的内容、将剪贴内容加载到上下文中（包括 Pastea 从屏幕截图中识别出的文本），并将剪贴内容放回剪贴板供你粘贴。

Pastea 自行运行 MCP 服务，且仅监听 127.0.0.1。本软件包是由 AI 应用启动的轻量级 无依赖桥接程序：它会查找 Pastea、请求一次访问权限——你只需在 Pastea 中点击「允许」——然后通过 stdio 转发消息。

安装

Claude Desktop

在 Pastea 中一键安装：打开 设置 → MCP 与 AI 工具，启用 启用 MCP，然后点击 Claude Desktop。Claude Desktop 将打开，Pastea 扩展已准备好安装。

也可以在 Claude Desktop 的 设置 → 扩展 → 浏览扩展 中找到 Pastea，或从 最新版本下载 pastea-mcp-<version>.mcpb 并双击。

Claude 首次使用时，Pastea 会询问你是否允许连接。

其他所有 AI 应用

使用 add-mcp 一次性将 Pastea 连接到所有已安装的 AI 应用：

npx add-mcp @pastea/mcp

或者自行连接每个应用：

Claude Code

claude mcp add pastea -- npx -y @pastea/mcp

Codex

codex mcp add pastea -- npx -y @pastea/mcp

Cursor

VS Code

其他任何支持 stdio MCP 服务的应用：

{ "mcpServers": { "pastea": { "command": "npx", "args": ["-y", "@pastea/mcp"] } } }

应用首次使用 Pastea 时，Pastea 会显示 「允许 <app> 使用你的剪贴板历史记录吗？」——点击「允许」后，工具便会显示。

从 Pastea 中连接

以上所有应用也可以直接在 Pastea 中连接——设置 → MCP 与 AI 工具， 点击对应应用的标签。Cursor 和 VS Code 会打开安装提示；Claude Code、Windsurf 和 Codex 会提供可直接粘贴的准确命令或配置，其中已包含访问令牌，因此无需配对提示。

你的助手可以做什么

工具	功能
search_clips	搜索剪贴板历史记录和列表，包括文本、链接、文件名以及从屏幕截图中识别出的文本。
get_clip	完整读取一条剪贴内容；图片会附带缩略图。
list_collections	列出历史记录和你创建的列表，并显示数量。
copy_clip	将剪贴内容原样放回系统剪贴板。你可以自行按 ⌘V 粘贴。
pastea_status	查看 Pastea 是否可访问并已连接；如果没有，还会说明该怎么做。

AI 工具永远无法删除剪贴内容，也不会将内容粘贴到其他应用中，并且看不到 Pastea 隐藏的条目（例如来自密码管理器的内容）。

配对工作原理

该桥接程序不附带凭据。首次使用时，它会向 Pastea 请求访问权限，Pastea 会显示 “允许 Claude Desktop 使用你的剪贴板历史记录吗？”（或 Cursor、Codex，……）。点击“允许” 后，工具很快就会出现；点击“不允许”则不会授予任何权限，助手会获得一个说明情况的 pastea_status 工具。

连接会列在 Pastea → Settings → MCP & AI Tools → Connected AI Tools 中，你可以在此撤销各项连接。只有当你要求助手重新连接时，Pastea 才会再次询问。

要求

• macOS 15 或更高版本
• Pastea 1.3+，并订阅 Pastea Pro，同时在 Settings → MCP & AI Tools 中开启 Enable MCP
• 使用 npx 安装时：需要 Node.js 20+（Claude Desktop 无需安装任何内容，它自带所需组件）

隐私政策

Pastea MCP 在你的 Mac 本地运行。

• 它仅连接到 127.0.0.1 上的 Pastea，不会连接其他任何对象。它不会向 Nexo Labs 或任何第三方发起网络请求，也不会收集分析数据或遥测数据。
• 它只会在你点击 Pastea 中的“允许”后，在 Pastea 与运行它的 AI 应用之间传输剪贴板数据。AI 应用如何处理它读取的剪贴内容，由该应用自身的隐私政策规定。
• 它只存储一项内容：你点击“允许”时 Pastea 签发的访问令牌，保存在 ~/Library/Application Support/Pastea/MCP Bridge/tokens.json 中，且仅你的用户帐户可读取。在 Pastea 中撤销连接会立即使其失效；卸载 Pastea 会移除此文件。
• 它无法访问隐藏的剪贴内容，也无法删除任何内容。

完整政策——关于 Pastea 处理哪些数据、数据如何存储、共享、保留，以及联系方式： https://pastea.app/privacy。

故障排除

“Pastea 未运行，或其 MCP 端点已关闭。” 打开 Pastea，并在 Settings → MCP & AI Tools 中开启 Enable MCP，然后让助手调用 pastea_status。

“需要 Pastea Pro。” MCP 访问是 Pro 功能。请在 Pastea 的 Settings 中订阅，然后调用 pastea_status。

“Pastea 正在请求用户允许此连接。” 找到 Pastea 窗口——它可能被 AI 应用挡住了——然后点击允许。

工具消失了。 连接已在 Pastea 中撤销，或 Pastea 已重置。让助手调用 pastea_status 以重新配对。

连接后未显示工具。 完全退出并重新打开 AI 应用，使其重新启动桥接程序。

更改了 Pastea 的端口？ 桥接程序每次启动时都会从 Pastea 的偏好设置中读取端口；请重启 AI 应用。

Claude Desktop 的日志：~/Library/Logs/Claude/mcp-server-Pastea.log。桥接程序绝不会记录令牌。

开发

npm install
npm test            # node --test, no network
npm run build       # tsc → dist/
scripts/pack.sh     # validate + pack → build/pastea-mcp-<version>.mcpb + SHA256SUMS

手动连接到开发版 Pastea 运行：

PASTEA_MCP_URL=http://127.0.0.1:41418/mcp node dist/index.js

然后在 stdin 中输入 JSON-RPC 行（initialize、notifications/initialized、tools/list）。 发布时通过标记 v<version>（与 package.json、manifest.json、server.json 和 src/version.ts 中的版本一致）创建版本标签；工作流会打包并发布该程序包。

贡献

欢迎提交问题和拉取请求——请参阅问题跟踪器。

许可证

MIT © Nexo Labs