MacOS Clipboard MCP Server

MacOS Clipboard MCP Server

site icon
2025.03.08 4
TypeScript剪贴板管理macOS 工具开发效率
clipboard-mcp 是一个 macOS 剪贴板管理服务,通过 OSAScript 提供对 macOS 剪贴板内容的访问。该工具允许 AI 助手查看用户剪贴板上的内容,包括文本、图像和二进制数据。
View on GitHub

Overview

基本能力

产品定位

clipboard-mcp 是一个专门为 macOS 设计的剪贴板管理服务,旨在提供对剪贴板内容的实时访问和管理。

核心功能

  • 从 macOS 剪贴板检索内容
  • 支持多种内容类型:
  • 文本
  • 图像(PNG)
  • 原始二进制数据

适用场景

  • AI 助手需要访问用户剪贴板内容时
  • 开发过程中需要实时监控或管理剪贴板内容
  • 需要处理多种类型剪贴板数据的应用程序

工具列表

  • bun run start: 启动服务器
  • bun run dev: 开发模式,支持热重载
  • bun run dev2: 使用 fastmcp dev 运行
  • bun run inspect: 使用 fastmcp inspector 运行
  • bun run mcp-cli: 使用 mcp-cli 工具运行

常见问题解答

  • 该服务仅支持 macOS 操作系统
  • 需要 Bun 运行时环境
  • 剪贴板内容应在每次请求时检查,不应缓存,因为内容可能在请求之间发生变化

使用教程

使用依赖

  • macOS 操作系统
  • Bun 运行时

安装教程

bun install

调试方式

启动服务器:

bun run start

开发模式(热重载):

bun run dev

其他开发模式:

bun run dev2      # 使用 fastmcp dev 运行
bun run inspect   # 使用 fastmcp inspector 运行
bun run mcp-cli   # 使用 mcp-cli 工具运行

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。