内容
# 工具列表
**300+ 模型上下文协议工具，均在设备上运行。** ToolPiper 是一个本地的 macOS 应用，它将您的 Mac 变成一个本地 AI 平台：捆绑推理（llama.cpp on Metal, Apple Intelligence, voice on the Neural Engine），一个兼容 OpenAI 的 API 在 `localhost:9998`，以及一个内置的 MCP 服务器，暴露整个机器给任何 MCP 客户端 — Claude Code, Cursor, Windsurf, 或您自己的脚本。
无需云服务。无需 Docker。无需 Python。无需 API 密钥。没有任何数据离开您的 Mac，您可以自己验证：`lsof -i -P | grep ToolPiper` 在它运行时。
- **网站：** https://modelpiper.com/toolpiper
- **下载：** https://modelpiper.com （免费 — 完整的本地模型运行器无限制，需要无需账号）
- **文档：** https://modelpiper.com/docs/toolpiper
- **社区：** https://github.com/ModelPiper/modelpiper-community
> 此仓库是 ToolPiper 的官方 MCP 服务器清单、设置指南和食谱的家园。ToolPiper 应用本身并非开源 — 但其隐私声明不需要信任：每个字节的网络流量都可以在您自己的机器上观察到。开源兄弟姐妹位于此组织： [PiperSR](https://github.com/ModelPiper/PiperSR) （ANE 超分辨率模型）， [FluidAudio](https://github.com/ModelPiper/FluidAudio)， [mlx-audio-swift](https://github.com/ModelPiper/mlx-audio-swift)。
## 快速开始
从 [modelpiper.com](https://modelpiper.com) 安装 ToolPiper，启动一次，然后连接任何 MCP 客户端。
**可流式 HTTP** （零配置 — 环回连接无需身份验证）：
```bash
claude mcp add --transport http toolpiper http://127.0.0.1:9998/mcp
```
```json
{
"mcpServers": {
"toolpiper": { "type": "http", "url": "http://127.0.0.1:9998/mcp" }
}
}
```
**stdio** （`~/.toolpiper/mcp` 符号链接在启动时自动创建）：
```bash
claude mcp add toolpiper -- ~/.toolpiper/mcp
```
```json
{
"mcpServers": {
"toolpiper": { "type": "stdio", "command": "/Users/<you>/.toolpiper/mcp" }
}
}
```
## 目录中有什么
300+ 工具，5 个资源和 5 个工作流提示。名称遵循 `<category>_<action>` （`vision_ocr`, `system_window_snap`, `browser_assert`）。完整的目录仅发送名称（~24 KB），因此它适合 Claude Code 的每个服务器的有效载荷上限，而无需修剪。
| 类别 | 示例 | 涵盖内容 |
|---|---|---|
| 核心 AI | `chat`, `audio_transcribe`, `audio_speak`, `text_embed` | 本地 LLM 推理，语音转文本和文本转语音在神经引擎上，嵌入 |
| Apple 框架 + RAG | `vision_ocr`, `image_analyze`, `text_analyze`, `rag_query` | Apple Vision OCR，11 个视觉端点，6 个 NLP 端点，混合 HNSW + BM25 文档搜索 |
| 浏览器自动化 | `browser_snapshot`, `browser_action`, `browser_assert`, `browser_intercept` | 通过 CDP 的 Chrome：AX 树快照，自愈选择器，网络模拟，Web Vitals，覆盖率 |
| 测试 | `test_run`, `test_save`, `test_export` | 保存的浏览器测试会话，~10–50 毫秒/步骤重放，Playwright/Cypress 导出 |
| 系统操作 | `system_*` — 26 个 macOS 域上的 ~140 个工具 | Windows，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 搜索控制台 |
| 模型管理 | `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`
### 类别过滤（stdio）
不需要所有 300 个工具都放在上下文中？在连接时过滤 — 工具列表和服务器指令都匹配并修剪：
```bash
# 仅限 LLM 推理（11 个工具）
claude mcp add toolpiper -- ~/.toolpiper/mcp --category core
# Web 开发工作流（34 个工具）
claude mcp add toolpiper -- ~/.toolpiper/mcp --profile automation
```
## 传输
| 传输 | 端点 | 身份验证 |
|---|---|---|
| 可流式 HTTP | `POST http://127.0.0.1:9998/mcp` (+ `GET /mcp` SSE 通道用于 `tools/list_changed`) | 环回对等体无需身份验证 — 在内核套接字上强制执行，因此 `Host`/`Origin` 伪造无法扩大范围。LAN/远程对等体需要 `Authorization: Bearer`。 |
| stdio | `~/.toolpiper/mcp` | 自动读取本地环境令牌 |
## 隐私
ToolPiper 永远不会调用外部服务。无遥测，无分析，无崩溃上传，无帐户要求。唯一的网络流量是您请求的流量（从 HuggingFace 下载模型，显式针对 Web 的工具）。这是您可以检查的属性，而不是您必须信任的策略：
```bash
lsof -i -P | grep ToolPiper
```
## 要求和定价
- Apple Silicon 上的 macOS
- **免费：** 完整的本地模型运行器 — 无限制，无需账号
- **专业版（$10/月）：** 所有 9 个推理后端，完整的语音套件等 — 请参阅 [定价](https://modelpiper.com/pricing)
## 常见问题
**这与“ToolPipe”相同吗？** 不。ToolPiper（此页面，`modelpiper.com`）是 ModelPiper 的 macOS MCP 服务器。某些目录中存在具有相似名称的无关项目。
**此仓库中的 MIT 许可证涵盖什么？** 仓库的内容 — 服务器清单，设置指南和食谱。ToolPiper 应用本身是专有的（免费层 + 专业版）。
**它在没有互联网连接的情况下是否有效？** 是的 — 推理，语音，视觉，RAG 和系统工具均在设备上运行。您只需要网络来下载模型。
**其他机器可以连接吗？** 环回配置为零。LAN/远程访问通过 bearer-token 身份验证。
