Toolpiper
io.github.ModelPiper由 GitHub 账号 ModelPiper 发布v0.0.10-beta更新于 Oct 25, 2026
On-device MCP tools for macOS: local AI, speech, vision, browser automation, system control.
概览
ToolPiper 是一款原生 macOS 应用,其本地 MCP 服务器提供 450 多个端侧工具,涵盖本地 AI、语音、视觉、浏览器自动化与系统控制。
- 可以做什么
- 在 Mac 上运行本地大模型对话、语音转文字、文字转语音与向量嵌入
- 对图片做 OCR、图像分析、文本分析,并检索本地文档索引
- 通过 CDP 驱动 Chrome:快照、操作、断言、网络模拟、Web Vitals
- 保存、回放浏览器测试并导出为 Playwright 或 Cypress
- 控制系统:窗口、空间、剪贴板、音频、显示器、访达、日历、提醒事项、通讯录、通知、进程、网络、蓝牙与快捷指令
- 录制与剪辑屏幕视频、比较 GitHub 仓库、管理内容队列、读取 Search Console,以及搜索、下载和加载模型
- 适用场景
- 适合希望助手在 Mac 上直接操作本机并使用本地模型、不依赖云服务的场景,例如桌面自动化、浏览器测试、OCR 与语音、私有文档检索。适用于运行 macOS 26 或更高版本的 Apple Silicon Mac。
- 运行要求
- 需要 macOS 26 或更高版本的 Apple Silicon Mac,并安装 ToolPiper 应用且启动一次。MCP 端点为回环地址 9998 端口上的 Streamable HTTP;回环连接无需认证,局域网与远程连接使用 bearer 令牌。本地使用无需 API 密钥或账号,仅在下载模型或接入可选云服务时需要网络。
安装
在 SourceWeft 中
- 打开 控制台中的 Toolpiper,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
ToolPiper MCP Server for macOS
450+ Model Context Protocol tools, all running on-device. ToolPiper is a native macOS app that turns your Mac into a local AI platform: bundled inference (llama.cpp on Metal, Apple Intelligence, speech on the Neural Engine), an OpenAI-compatible API at localhost:9998, and a built-in MCP server that exposes the whole machine to any MCP client: Claude Code, Cursor, Codex, or your own scripts.
No cloud required for local models. No Docker. No Python. No API keys. Your prompts, files and outputs stay on your Mac, and you can check what ToolPiper connects to yourself: lsof -i -P | grep ToolPiper while it runs.
- Website: https://modelpiper.com/toolpiper
- Download: https://modelpiper.com/download (free; the full local model runner has no caps and needs no account)
- Docs: https://modelpiper.com/docs/toolpiper
- Tool catalog: https://modelpiper.com/mcp-tools
- Community: https://github.com/ModelPiper/modelpiper-community
This repository is the official home for ToolPiper's MCP server manifest (
server.json), the Claude Code plugin (plugins/toolpiper), and the setup guides. The ToolPiper app itself is not open source, but its privacy claims do not ask for trust: every byte of network traffic is observable on your own machine. Open-source siblings live in this org: PiperSR (ANE super-resolution model), FluidAudio, mlx-audio-swift.
Quick start
Install ToolPiper, launch it once, then connect any MCP client over Streamable HTTP. Loopback connections need no auth: no token, no OAuth step.
Download the disk image from modelpiper.com/download, or install with Homebrew:
The trust line is required once: Homebrew 6 refuses casks from taps outside its own until you trust them.
Claude Code, as a plugin (one server entry, nothing to configure by hand):
Claude Code, as a manual server:
Codex, as a plugin:
Or as a manual server: codex mcp add toolpiper --url http://127.0.0.1:9998/mcp. Codex signs in to ToolPiper once; approve ToolPiper's consent page when it appears.
Any other MCP client, in its server configuration:
Claude Desktop, as a one-click extension: download toolpiper-1.0.1.mcpb from Releases and double-click it; Claude Desktop shows its install sheet. The JSON block above does not apply to Claude Desktop, whose config file runs local stdio servers only. Source, build script and privacy statement: desktop-extension/. It is a small Node.js forwarder that relays Claude Desktop's stdio to the same loopback server, and it serves the directory profile: the catalog minus every tool that uses an AI model to generate images, video or audio.
Installing with an AI agent? Point it at llms-install.md.
What's in the catalog
450+ tools, 5 resources, and 5 workflow prompts. Names follow <category>_<action> (vision_ocr, system_window_snap, browser_assert). The live catalog, with per-tool documentation, is at modelpiper.com/mcp-tools.
Resources: toolpiper://status, toolpiper://models, toolpiper://backends, toolpiper://tests, toolpiper://categories
Prompts: setup-model, audit-page, create-test, voice-over, research-topic
Category and profile filtering
Don't want the whole catalog in context? Pass category or profile as a query parameter on the /mcp URL. Both the tool list and the server instructions trim to match:
Transport
Streamable HTTP is the only transport. ToolPiper has no stdio server, and older guides that described one are obsolete.
Privacy
Your prompts, files and outputs stay on your Mac when you use local models. ToolPiper contacts our servers for update checks, a license check when you're signed in and a daily activity count, and it can send optional usage counts. You can turn the last two off in Settings, and none of them include your content. There are no crash uploads, and local use needs no account. Everything else is traffic you ask for: model downloads from HuggingFace, a cloud provider you add, and tools that explicitly target the web. You can watch it yourself:
You will see update, license and activity requests to modelpiper.com hosts, optional usage counts to PostHog if you leave them on, plus any downloads or providers you chose, and none of them carry your content. Full policy: modelpiper.com/privacy.
Requirements and pricing
- macOS 26 or later on Apple Silicon
- Free: the full local model runner and every speech feature (transcription, text to speech, dictation). No caps, no account.
- Paid plans add more of the catalog. The current ladder is at modelpiper.com/pricing.
FAQ
Is this the same as "ToolPipe"? No. ToolPiper (this page, modelpiper.com) is the macOS MCP server by ModelPiper. Unrelated projects with similar names exist in some directories.
What does the MIT license in this repo cover? The contents of this repository: the server manifest, the Claude Code plugin, and the setup guides. The ToolPiper app itself is proprietary.
Does it work without an internet connection? Yes. Inference, speech, vision, RAG, and system tools are all on-device. You only need the network to download models.
Can other machines connect? Loopback is zero-config. LAN and remote access go through bearer-token auth.
I already added ToolPiper with claude mcp add. Do I need the plugin? No. Claude Code keeps your manual toolpiper server and skips the plugin's copy while the manual one exists, so nothing doubles up. The plugin is for a fresh setup, or if you remove the manual entry.
来源:README.md,提交 5902f5b
工具
0版本历史
2- v0.0.10-beta最新Oct 16, 2026
- v0.0.9-betaSep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分