toolpiper

面向 macOS 的 ToolPiper MCP 服务

400 多种 Model Context Protocol 工具，全部在设备上运行。 ToolPiper 是一款原生 macOS 应用，可将你的 Mac 变成一个本地 AI 平台：内置推理能力（基于 Metal 的 llama.cpp、Apple Intelligence，以及在 Neural Engine 上运行的语音处理）、位于 localhost:9998 的 OpenAI 兼容 API，以及一个内置 MCP 服务，可向任何 MCP 客户端开放整台设备：Claude Code、Cursor、Codex，或你自己的脚本。

本地模型无需云服务。无需 Docker。无需 Python。无需 API 密钥。你的提示词、文件和输出都留在 Mac 上；你还可以在 ToolPiper 运行时自行检查它连接的内容：lsof -i -P | grep ToolPiper。

• 网站： https://modelpiper.com/toolpiper
• 下载： https://modelpiper.com/download（免费；完整的本地模型运行器没有限制，也无需账户）
• 文档： https://modelpiper.com/docs/toolpiper
• 工具目录： https://modelpiper.com/mcp-tools
• 社区： https://github.com/ModelPiper/modelpiper-community

此仓库是 ToolPiper MCP 服务清单（server.json）、Claude Code 插件（plugins/toolpiper）和设置指南的官方存放处。ToolPiper 应用本身并非开源，但其隐私声明无需你盲目信任：你可以在自己的设备上观察每一字节的网络流量。本组织还托管了同系列开源项目：PiperSR（ANE 超分辨率模型）、FluidAudio、mlx-audio-swift。

快速开始

安装 ToolPiper，启动一次，然后通过 Streamable HTTP 连接任意 MCP 客户端。环回连接无需身份验证：不需要令牌，也无需 OAuth 步骤。

从 modelpiper.com/download 下载磁盘映像，或使用 Homebrew 安装：

brew tap modelpiper/tap
brew trust modelpiper/tap
brew install --cask toolpiper

必须运行一次 trust 命令：Homebrew 6 会拒绝来自其自有 tap 以外的 tap 的 cask，除非你先信任它们。

将 Claude Code 用作插件（只需配置一个服务条目，无需手动设置）：

claude plugin marketplace add ModelPiper/toolpiper
claude plugin install toolpiper@modelpiper

将 Claude Code 用作手动配置的服务：

claude mcp add --transport http toolpiper http://127.0.0.1:9998/mcp

将 Codex 用作插件：

codex plugin marketplace add ModelPiper/toolpiper
codex plugin add toolpiper@modelpiper

或者将其配置为手动服务：codex mcp add toolpiper --url http://127.0.0.1:9998/mcp。Codex 会登录 ToolPiper 一次；出现 ToolPiper 的授权页面时，请批准授权。

其他任何 MCP 客户端，在其服务配置中添加：

{
  "mcpServers": {
    "toolpiper": { "type": "http", "url": "http://127.0.0.1:9998/mcp" }
  }
}

将 Claude Desktop 用作一键式扩展： 从 Releases 下载 toolpiper-1.0.0.mcpb，然后双击；Claude Desktop 会显示安装界面。上方的 JSON 代码块不适用于 Claude Desktop，因为它的配置文件只运行本地 stdio 服务。源代码、构建脚本和隐私声明见 desktop-extension/。这是一个小型 Node.js 转发器，可将 Claude Desktop 的 stdio 请求转发到同一环回服务，并提供 directory 配置：工具目录中不包含任何使用 AI 模型生成图像、视频或音频的工具。

使用 AI Agent 安装？将它指向 llms-install.md。

目录中有什么

400 多个工具、5 个资源和 5 个工作流提示词。名称遵循 <category>_<action>（vision_ocr、system_window_snap、browser_assert）。实时目录及各工具文档请见 modelpiper.com/mcp-tools。

类别	示例	涵盖内容
核心 AI	chat、audio_transcribe、audio_speak、text_embed	本地大模型推理、在 Neural Engine 上进行语音转文本和文本转语音、嵌入
Apple 框架 + RAG	vision_ocr、image_analyze、text_analyze、rag_query	Apple Vision OCR、图像分析、自然语言分析、混合 HNSW + BM25 文档搜索
浏览器自动化	browser_snapshot、browser_action、browser_assert、browser_intercept	通过 CDP 控制 Chrome：AX 树快照、自愈选择器、网络模拟、Web Vitals、覆盖率
测试	test_run、test_save、test_export	保存的浏览器测试会话、快速回放、导出 Playwright/Cypress
系统操作	system_*	窗口、Spaces、剪贴板（含 OCR 历史记录）、音频、显示器、Finder、日历、提醒事项、通讯录、通知、进程、网络、蓝牙、快捷指令等
视频创作	video_record、video_render、video_edit_timeline	屏幕录制脚本、非破坏性时间线编辑、OTIO/FCP XML/EDL 导出
外联	hn_search、reddit_search、github_compare、gsc_analytics	HN、Reddit、GitHub、Google Search Console
模型管理	model_search、model_download、model_load	搜索 HuggingFace、下载 GGUF/CoreML、加载/卸载
路由 + 集成	endpoint_set、endpoint_recommend、claude_code_install	按会话切换推理端点、安装 Claude Code 助手

资源： toolpiper://status、toolpiper://models、toolpiper://backends、toolpiper://tests、toolpiper://categories 提示词： setup-model、audit-page、create-test、voice-over、research-topic

类别和配置筛选

不想把整个目录都放入上下文？在 /mcp URL 中将 category 或 profile 作为查询参数传入。工具列表和服务指令都会相应精简：

# Just LLM inference (core category)
claude mcp add --transport http toolpiper "http://127.0.0.1:9998/mcp?category=core"

# Web dev workflow (automation profile: core + browser + testing)
claude mcp add --transport http toolpiper "http://127.0.0.1:9998/mcp?profile=automation"

传输方式

传输方式	端点	身份验证
Streamable HTTP	POST http://127.0.0.1:9998/mcp（以及 GET /mcp，用于 tools/list_changed 的 SSE 通道）	回环对等方无需身份验证，并在内核套接字层强制执行，因此伪造 Host/Origin 无法扩大访问范围。局域网和远程对等方需提供 Authorization: Bearer。

Streamable HTTP 是唯一的传输方式。ToolPiper 没有 stdio 服务，旧版指南中对此的描述已过时。

隐私

使用本地模型时，你的提示词、文件和输出都会保留在 Mac 上。ToolPiper 会联系我们的服务器以检查更新、在你登录时检查许可证，并统计每日活动量；它还可以发送可选的使用量统计。你可以在“设置”中关闭后两项，它们都不包含你的内容。我们不会上传崩溃报告，本地使用也无需账号。其他所有网络流量都是你主动请求的：从 HuggingFace 下载模型、连接你添加的云服务提供商，以及明确面向 Web 的工具。你可以自行查看：

lsof -i -P | grep ToolPiper

你会看到发往 modelpiper.com 主机的更新、许可证和活动统计请求；如果你选择保留开启，还会看到发往 PostHog 的可选使用量统计，以及你选择的任何下载或服务提供商请求。这些请求都不会携带你的内容。完整政策：modelpiper.com/privacy。

要求和定价

• Apple Silicon 上运行 macOS 26 或更高版本
• **免费：**完整的本地模型运行器和所有语音功能（转录、文本转语音、听写）。无上限，无需账号。
• 付费套餐可解锁更多目录内容。当前套餐请见 modelpiper.com/pricing。

常见问题

这和“ToolPipe”是同一个项目吗？ 不是。ToolPiper（本页面，modelpiper.com）是 ModelPiper 的 macOS MCP 服务。一些目录中存在名称相似但互不相关的项目。

此代码库中的 MIT 许可证涵盖哪些内容？ 涵盖此代码库的内容：服务清单、Claude Code 插件和设置指南。ToolPiper 应用本身是专有软件。

没有互联网连接也能使用吗？ 可以。推理、语音、视觉、RAG 和系统工具都在设备本地运行。只有下载模型时才需要网络。

其他设备可以连接吗？ 回环连接无需配置。局域网和远程访问通过持有者令牌进行身份验证。

我已经用 claude mcp add 添加了 ToolPiper。还需要插件吗？ 不需要。只要手动添加的 toolpiper 服务仍然存在，Claude Code 就会保留它并跳过插件中的副本，因此不会重复添加。插件适用于全新设置，或者你移除了手动添加的条目时。