ToolPiper MCP server
2026년 11월 6일 커밋450개 이상의 온디바이스 도구를 MCP 클라이언트에 제공하여 Mac을 로컬 AI 플랫폼으로 변환합니다. 음성, 비전, 브라우저 자동화 및 시스템 제어 기능을 지원합니다.
다른 이름 ModelPiper/toolpiper
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.0.10-beta
- 마지막 커밋
- 2026년 11월 6일
- 라이선스
- MIT
ToolPiper MCP란?
ToolPiper은(는) MCP server입니다. 450개 이상의 온디바이스 도구를 MCP 클라이언트에 제공하여 Mac을 로컬 AI 플랫폼으로 변환합니다. 음성, 비전, 브라우저 자동화 및 시스템 제어 기능을 지원합니다.
프로젝트 README에서 생성된 요약
ToolPiper MCP server 정보
ToolPiper는 450개 이상의 온디바이스 도구를 MCP 클라이언트에 노출하여 Mac을 로컬 AI 플랫폼으로 변환합니다. macOS에서 네이티브로 실행되며 Apple Silicon을 활용하여 클라우드 서비스나 API 키 없이도 음성, 비전, 브라우저 자동화 및 시스템 제어 기능을 제공합니다. 이 server는 Metal 기반의 llama.cpp, Apple Intelligence, Neural Engine을 사용하여 추론 및 음성 작업을 로컬에서 처리합니다.
개발자는 localhost:9998의 로컬 루프백 연결을 통해 streamable HTTP 방식으로 Claude Code, Cursor, Codex와 같은 다양한 클라이언트를 연결할 수 있습니다. 설정 과정은 프라이버시를 우선하도록 설계되어 프롬프트와 파일이 기기 내에 머물도록 보장합니다. 사용자는 Homebrew를 통해 애플리케이션을 설치하거나 디스크 이미지를 직접 다운로드할 수 있습니다. 핵심 로컬 모델 러너는 무료이며 사용 제한이 없지만, 도구 카탈로그의 일부 기능은 유료 플랜을 통해 제공됩니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능modelpiper/toolpiper is public and reachablegithub.com/modelpiper/toolpiper ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-06github.com/modelpiper/toolpiper ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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:
brew tap modelpiper/tap
brew trust modelpiper/tap
brew install --cask toolpiper
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 plugin marketplace add ModelPiper/toolpiper
claude plugin install toolpiper@modelpiper
Claude Code, as a manual server:
claude mcp add -s user --transport http toolpiper http://127.0.0.1:9998/mcp
Codex, as a plugin:
codex plugin marketplace add ModelPiper/toolpiper
codex plugin add toolpiper@modelpiper
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:
{
"mcpServers": {
"toolpiper": { "type": "http", "url": "http://127.0.0.1:9998/mcp" }
}
}
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.
| Category | Examples | What it covers |
|---|---|---|
| Core AI | chat, audio_transcribe, audio_speak, text_embed |
Local LLM inference, speech-to-text and text-to-speech on the Neural Engine, embeddings |
| Apple frameworks + RAG | vision_ocr, image_analyze, text_analyze, rag_query |
Apple Vision OCR, image analysis, natural-language analysis, hybrid HNSW + BM25 document search |
| Browser automation | browser_snapshot, browser_action, browser_assert, browser_intercept |
Chrome via CDP: AX-tree snapshots, self-healing selectors, network mocking, Web Vitals, coverage |
| Testing | test_run, test_save, test_export |
Saved browser test sessions, fast replay, Playwright/Cypress export |
| System actions | system_* |
Windows, Spaces, clipboard (with OCR'd history), audio, displays, Finder, Calendar, Reminders, Contacts, notifications, processes, network, Bluetooth, Shortcuts, and more |
| Video creator | video_record, video_render, video_edit_timeline |
Screen-recorded screenplays, non-destructive timeline editing, OTIO/FCP XML/EDL export |
| Outreach | github_compare, queue_add, gsc_analytics |
GitHub, the content queue, Google Search Console |
| Model management | model_search, model_download, model_load |
Search HuggingFace, download GGUF/CoreML, load/unload |
| Routing + integrations | endpoint_set, endpoint_recommend, claude_code_status |
Switch inference endpoints per session, see how Claude Code connects |
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:
# Just LLM inference (core category)
claude mcp add -s user --transport http toolpiper "http://127.0.0.1:9998/mcp?category=core"
# Web dev workflow (automation profile: core + browser + testing)
claude mcp add -s user --transport http toolpiper "http://127.0.0.1:9998/mcp?profile=automation"
Transport
| Transport | Endpoint | Auth |
|---|---|---|
| Streamable HTTP | POST http://127.0.0.1:9998/mcp (plus GET /mcp, the SSE channel for tools/list_changed) |
None for loopback peers, enforced at the kernel socket, so Host/Origin spoofing cannot widen it. LAN and remote peers present Authorization: Bearer. |
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:
lsof -i -P | grep ToolPiper
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.
ToolPiper MCP 질문
인터넷 연결 없이도 작동하나요?
네, 추론, 음성, 비전, RAG 및 시스템 도구는 모두 온디바이스로 실행됩니다. 인터넷은 모델을 다운로드할 때만 필요합니다.
ToolPipe와 동일한 제품인가요?
아니요, ToolPiper는 ModelPiper에서 개발한 macOS MCP server이며, 이름이 유사한 다른 프로젝트와는 별개의 제품입니다.
다른 기기에서도 서버에 연결할 수 있나요?
루프백 연결은 별도 설정이 필요 없지만, LAN 및 원격 접속 시에는 bearer-token 인증이 필요합니다.
Claude Code를 통해 이미 추가했다면 플러그인이 필요한가요?
아니요, 수동 서버 항목이 이미 존재하는 경우 Claude Code는 플러그인 설치를 건너뜁니다.