Clippy MCP 服务器

使用说明(Markdown 格式):

  • 项目简介
    • 这是一个基于 MCP(Model Context Protocol)的服务器实现,旨在向 AI 客户端提供剪贴板相关的上下文信息和功能。它将资源、工具和提示以标准化的接口暴露出来,支持与 LLM 客户端通过 JSON-RPC 通信。
  • 主要功能点
    • 资源管理:通过 MCP 服务器暴露剪贴板相关的资源信息(如文本、文件引用等)。
    • 工具注册与执行:定义并注册若干量化工具(如 clipboard_copy、clipboard_paste、get_recent_downloads 等),允许 MCP 客户端调用以完成现场操作。
    • 提示与示例:为常用操作提供提示模板和示例,方便在对话中引导 LLM 正确使用工具。
    • JSON-RPC 通信:服务器通过标准的 MCP JSON-RPC 格式接收请求并返回响应。
    • 伺服器启动与元数据覆盖:支持从默认元数据加载、并可通过覆盖文件自定义工具、提示与示例描述。
  • 安装步骤
    • 需要在 macOS 环境下构建并运行(因为依赖 macOS 的剪贴板/粘贴板 API)。
    • 使用 Go 构建并运行 MCP 服务器(示例命令以 repo 内部实现为准)。
  • 服务器配置(MCP 客户端需要的配置示例)
    • 配置示例(JSON,供 MCP 客户端使用来与服务器建立连接;不需要在服务器端修改即可用于客户端打开连接) { "name": "clippy", "command": "clippy", "args": ["mcp-server"] } 注释说明:
    • name: MCP 服务器在客户端配置中的标识名,通常与服务器端实现的名称保持一致,便于管理与对照。
    • command: 用于启动 MCP 服务器的可执行文件名称,这里为 clippy,前提是系统 PATH 中能找到该可执行文件。
    • args: 启动服务器时传递的参数,这里传递 "mcp-server",用于进入 MCP 服务器模式(由仓库中的实现决定)。
    • 以上信息与仓库中的实现一致, Claude Desktop 等客户端文档示例也给出了类似配置方法。
  • 基本使用方法
    • 启动:在具备相应环境与依赖的机器上,执行客户端可用的启动命令以启动 MCP 服务器(示例:clippy mcp-server)。
    • 使用:在 AI 客户端(如 Claude、其他支持 MCP 的客户端)中,将该服务器添加为一个可用的 MCP 服务器;通过工具调用将剪贴板操作、最近下载、粘贴等功能暴露给 AI。
    • 监控与调试:服务器提供元数据覆盖、日志选项等,便于开发与排错。

服务器信息