snipper-mcp

snipper-mcp — SnipperApp 3 中的 MCP 服务

SnipperApp 3 是一款原生 macOS 代码片段管理器。它内置了自己的 Model Context Protocol 服务，因此 AI 助手可以搜索、读取、创建和整理你资料库中的代码片段。无需安装任何内容：该服务是随应用打包的 stdio 二进制文件。

此仓库介绍该服务的接口。服务本身是应用的一部分（使用 Swift 构建，基于 Swift MCP SDK）。

系统要求

• SnipperApp 3（Mac App Store 提供，免费试用 7 天）：https://apps.apple.com/us/app/snipperapp-3-code-snippets/id6757330954?mt=12
• macOS 15 或更高版本（Apple Silicon 或 Intel）

在 Claude Desktop 中安装（一键操作）

从最新版本下载 snipperapp-1.0.2.mcpb 并打开；Claude Desktop 会将其安装为扩展。该软件包仅包含一个小型启动器（mcpb/server/index.js），用于查找 SnipperApp 3 中的服务并转交 stdio。即使没有安装应用，它仍会响应 initialize 和 tools/list（清单位于 mcpb/server/tools.json），而每次工具调用都会返回清晰的未安装错误；Dockerfile 可运行此模式，供注册表检查使用。

设置（手动）

Claude Code：

claude mcp add snipper -- "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"

Claude Desktop、Cursor（.cursor/mcp.json）、Windsurf（~/.codeium/windsurf/mcp_config.json）：

{
  "mcpServers": {
    "snipper": {
      "command": "/Applications/SnipperApp 3.app/Contents/MacOS/snipper-mcp"
    }
  }
}

完整指南：https://snipperapp.com/docs/mcp-integration

工具（25 个）

类别	工具
代码片段	search_snippets、get_snippet、create_snippet、update_snippet、delete_snippet
文件夹	list_folders、create_folder、update_folder、delete_folder
标签	list_tags、create_tag、delete_tag、add_tag_to_snippet、remove_tag_from_snippet
附件	list_attachments、get_attachment、create_attachment、delete_attachment
组织管理	list_workspaces、list_storages、list_groups、list_languages
Hub（公开代码片段）	search_hub、get_hub_snippet、import_from_hub

每个工具都带有 title 和 MCP 注释，客户端会据此判断哪些操作需要确认：12 个读取工具标记为 readOnlyHint，5 个删除或移除标签的工具标记为 destructiveHint，3 个 Hub 工具标记为 openWorldHint。

该服务与应用读写同一个本地 SQLite 数据库，因此助手保存的任何内容都会立即显示在 SnipperApp 中。数据不会发送到任何服务；只有在使用 Hub 工具时，它们才会调用公开的 Hub API。

示例提示词

• “搜索我的代码片段，查找带退避重试的辅助函数，并粘贴到这里。”
• “将这个函数保存为代码片段，放入 Work 工作区的 Utilities 文件夹，并添加 postgres 标签。”
• “列出带 networking 标签的 Swift 代码片段。”

隐私政策

完整政策：https://snipperapp.com/privacy

服务器会收集什么。 什么也不收集。snipper-mcp 本身没有分析、遥测或崩溃报告功能。此存储库中的 MCPB 启动器完全不会发起网络请求——它要么将标准输入输出传递给捆绑的二进制文件，要么根据静态文件响应 tools/list。

数据的使用和存储方式。 服务器会在 Mac 上应用自己的容器内，读取和写入与 SnipperApp 3 相同的本地 SQLite 数据库。代码片段、文件夹、标签和附件不会离开你的设备，除非你自行启用了同步存储：iCloud（Apple CloudKit，你的私人数据库——开发者无法读取）或 GitHub Gist（使用你自己的 GitHub 凭据登录的账户）。

与第三方共享。 服务器不会共享数据。三个 Hub 工具（search_hub、get_hub_snippet、import_from_hub）会调用公开的 SnipperApp Hub API，且仅在助手调用它们时才会执行；它们只会发送搜索词或代码片段 ID，不会发送你资料库中的任何内容。不会上传任何代码片段内容。不会向广告商或数据经纪商出售或共享任何数据。

数据保留。 你的代码片段保存在 Mac 上，直到你将其删除；在 SnipperApp 3 中（或通过 delete_snippet）删除后，它们会从本地数据库以及你启用的任何同步存储中移除。开发者不会保留任何服务器端副本。Hub 请求不会关联到账户，也不会作为单个用户的历史记录予以保留。

联系方式。 [email protected]——如有疑问，或想了解我们持有哪些与你相关的信息并要求删除，请联系。

此存储库

• mcpb/ — MCPB 扩展：manifest.json、icon.png 和启动器 server/index.js。使用 npx @anthropic-ai/mcpb pack mcpb snipperapp-<version>.mcpb 重新构建。
• server.json — 官方 MCP 注册表的条目（mcp-publisher publish）。
• 启动器和这些文档采用 MIT 许可；SnipperApp 3 及其捆绑的 snipper-mcp 二进制文件为专有软件。

支持

[email protected] — 用于提交 Bug 报告、功能请求和隐私问题。文档：https://snipperapp.com/docs/mcp-integration