📄 工具详情 ⚙️ 安装教程 📚 使用教程
能力标签
🔌 MCP🤖 Agent💻 CLI🖼 视觉🧠 Claude✨ GPT⌨️ Cursor🖥 本地 LLM
scarf MCP工具
🛠
AI工具

scarf MCP工具

基于 Swift · 开源 AI 工具，GitHub 社区精选
英文名：scarf
⭐ 502 Stars 🍴 31 Forks 💻 Swift 📄 MIT 🏷 AI 8.2分
8.2AI 综合评分
MCP工具AI代理macOS应用Swift开发多窗口管理
🌐 访问官网 📺 TG 频道
✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：scarf MCP工具 是一款优质的AI工具。AI 综合评分 8.2 分，在同类工具中表现稳健。如果你正在寻找可靠的AI工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

scarf MCP工具 是一款基于 Swift 的开源工具，在 GitHub 上收获 1k+ Star，是MCP工具、AI代理、macOS应用、Swift开发领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
scarf MCP工具 依赖 Swift 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Swift 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 scarf MCP工具 的版本更新，及时通知重要功能变化。

📋 工具概览

为Hermes AI智能体打造的原生macOS和iOS应用，支持多窗口、多服务器连接。提供图形化界面管理AI代理任务，适合需要桌面级AI工具体验的开发者和专业用户。

scarf MCP工具 是一款基于 Swift 开发的开源工具，专注于 MCP工具、AI代理、macOS应用 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 502
开发语言
Swift
支持平台
macOS / iOS
维护状态
正常维护，社区驱动
开源协议
MIT
AI 综合评分
8.2 分
工具类型
AI工具
Forks
31

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

为Hermes AI智能体打造的原生macOS和iOS应用，支持多窗口、多服务器连接。提供图形化界面管理AI代理任务，适合需要桌面级AI工具体验的开发者和专业用户。

scarf MCP工具 是一款基于 Swift 开发的开源工具，专注于 MCP工具、AI代理、macOS应用 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费，支持本地部署，数据完全自主可控
  • 活跃的 GitHub 开源社区，持续迭代更新
  • 提供详细文档和使用示例，新手友好
  • 支持自定义配置，灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 克隆仓库
git clone https://github.com/awizemann/scarf
cd scarf

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 查看帮助
scarf --help

# 基本运行
scarf [options] <input>

# 详细使用说明请查阅文档
# https://github.com/awizemann/scarf
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
# scarf 配置说明
# 查看配置选项
scarf --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export SCARF_CONFIG="/path/to/config.yml"
📑 README 深度解析 真实文档 完整度 50/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

<p align="center"> <img src="icon-v2.5.png" width="128" height="128" alt="Scarf app icon"> </p>

Scarf

<p align="center"> <strong>The native Mac &amp; iOS app for your <a href="https://github.com/hermes-ai/hermes-agent">Hermes AI agent</a>.</strong><br> See every session, project, skill, memory file, and cron job — on your Mac, and from your iPhone over SSH. </p>

<p align="center"> <a href="https://awizemann.github.io/scarf/">Website</a> · <a href="https://github.com/awizemann/scarf/releases/latest">Download for Mac</a> · <a href="https://testflight.apple.com/join/qCrRpcTz">iPhone TestFlight</a> · <a href="https://github.com/awizemann/scarf/wiki">Wiki</a> · <a href="https://awizemann.github.io/scarf/#faq">FAQ</a> </p>

<p align="center"> <img src="https://img.shields.io/badge/macOS-14.6+-blue" alt="macOS 14.6+"> <img src="https://img.shields.io/badge/iOS-18+-blue" alt="iOS 18+"> <img src="https://img.shields.io/badge/Swift-6-orange" alt="Swift 6"> <img src="https://img.shields.io/badge/Hermes-v0.20-purple" alt="Hermes v0.20"> <img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"> </p>

<p align="center"> <a href="https://trendshift.io/repositories/26763?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-26763" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26763" alt="awizemann%2Fscarf | Trendshift" width="250" height="55"/></a> <a href="https://trendshift.io/repositories/26763?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-26763" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26763/daily?language=Swift" alt="awizemann%2Fscarf | Trendshift" width="250" height="55"/></a> <a href="https://trendshift.io/repositories/26763?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-26763" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/26763/weekly?language=Swift" alt="awizemann%2Fscarf | Trendshift" width="250" height="55"/></a> </p>

<p align="center"> <img src="site/landing/assets/screenshots/mac-hero.png" alt="Scarf on macOS — Dashboard" width="720"> </p>

What's New in 3.1.0

  • A sidebar built around your projects — projects live at the top of the sidebar in their own panel with folders, filtering, the full context menu, and a New Project button; the other sections collapse and expand, and Scarf remembers your arrangement.
  • Project chats stop nagging — flip "Auto-accept edits" in a project's Chat Settings and chats bound to that project apply edits without prompting (sensitive paths still ask, enforced by Hermes); or hit the approval dialog's new "Allow edits for this session" button. The setting is cryptographically bound to your machine, so an agent can't grant itself the bypass.
  • Mini-apps can open links — a new open_url permission hands links to your default browser: https-only, confirmed per host by name (Open once / Always allow), never without your click. The sandbox itself stays sealed.
  • Projects that can't be destroyed — atomic writes on every transport (iOS SFTP included), quarantine-and-refuse instead of overwrite on damage, rolling backups, a cross-process write lock, a Project Doctor that reconciles and repairs, and trust re-verified at time of use (uninstall containment, per-project keychain binding, signed mini-app grants).
  • Agents get real tools — the bundled scarf-projects MCP server covers the full project surface, including project_set_config with secrets routed straight to the Keychain; skills and slash commands now steer agents to tools instead of hand-editing JSON.
  • Much faster while agents stream — an unchanged watcher tick dropped from ~55–70 SSH round-trips to ~4; registry work moved fully off the main thread.
  • Accessibility — damage and repair announcements, severity spoken on doctor findings, Audio Graphs for charts, non-color status channels, and text that scales in dense widgets.
  • Heads-up: mini-apps re-ask for their permissions once after upgrading (grants are now signed); project keychain secrets migrate automatically on next read.

Full notes: v3.1.0 · all previous releases: Release Notes Index.

Features

Scarf mirrors Hermes's whole surface through a sidebar UI. Sections marked ⚙ are capability-gated — they appear only when the connected host's Hermes version supports them.

Requirements & compatibility

  • macOS 14.6+ (Scarf) · iOS 18+ (ScarfGo) · Xcode 16+ to build from source.
  • Hermes v0.6.0+ on each host. Current target: v0.20.4 "Herald" (v2026.8.18) — every newer surface is capability-gated or schema-detected, so older hosts keep working with newer-only UI hidden.
HermesStatus
v0.6.0 – v0.17.0 (2026-03 → 2026-06)Verified — full feature history in the [wiki compatibility page](https://github.com/awizemann/scarf/wiki/Hermes-Version-Compatibility)
v0.18.x (2026-07)Verified — messages.compacted schema detection, MoA + Vertex providers
v0.19.x "Quicksilver"Verified — audited as part of the v0.18.2 → v0.20.0 source delta
v0.20.0 "Herald" (2026-08-03)Verified — pinned sessions, per-model cost, new exports, /compress, cron run history, profile routing
v0.20.4 "Herald" (2026-08-18)**Verified — current target** — curator ledger/purge, project skills, unread sessions, MCP catalog + identity headers, personalities-in-code

Scarf reads Hermes's SQLite database and CLI output with automatic schema detection. If a Hermes update changes either, the Health view shows compatibility warnings.

Install

Build from source

git clone https://github.com/awizemann/scarf.git
cd scarf/scarf
open scarf.xcodeproj

No Apple Developer account? Use ./scripts/local-build.sh for an unsigned Debug build — see BUILDING.md.

Configure

  • Platforms — native setup forms for Hermes's messaging platforms (Telegram, Discord, Slack, WhatsApp, Signal, iMessage, Matrix, ntfy, and more) including QR pairing flows.
  • Personalities · Quick Commands · Credential Pools · Plugins · Webhooks · Profiles — every Hermes identity/extension surface, with safe write paths.
  • Models ⚙ — the model picker as a first-class pane, with local-model discovery (Ollama, LM Studio, vLLM, llama.cpp — local or over SSH), context-window guards, and vision-capability warnings.
  • Hermes Proxy ⚙ — launch Hermes's OpenAI-compatible local proxy and point Codex CLI / Aider / Cline / Continue at it.
🇨🇳 中文文档镜像 AI 翻译 2026-05-29
英文原文章节由系统翻译为中文摘要，便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

Scarf 是一款专为 Hermes AI agent 设计的原生 macOS 伴侣应用。它为用户提供了对 Hermes 运行状态的全面可视化能力，让你可以实时监控 Hermes 的执行过程、操作时间以及它所创建的所有内容，确保 AI Agent 的每一个动作都清晰可见、有迹可循。

⚡ 功能介绍

Scarf 的 UI 设计与 Hermes 的侧边栏完全同步，实现了功能的 1:1 映射。通过最新的 v2.9 版本，Scarf 已全面适配 Hermes v0.14.0 的“基础发布版”功能，支持包括 `/subgoal`、`/yolo`、`/sessions` 及 `/codex-runtime` 在内的全新斜杠命令，并集成了 xAI Grok、NovitaAI 等推理提供商以及 Brave Search、DuckDuckGo 等 Web 搜索后端，提供与 OpenAI 兼容的强大体验。

📋 环境依赖

运行 Scarf 需要 macOS 14.6+ (Sonoma) 系统；若需使用 iPhone 伴侣应用 ScarfGo，则需 iOS 18.0+；从源码构建则需 Xcode 16.0+。此外，远程主机必须具备 SSH 访问权限（通过本地 ssh-agent 进行密钥认证，无需手动输入密码），并且 `$PATH` 中必须包含 `sqlite3`，以便进行原子化的数据库快照操作。

🛠 安装步骤（Docker/pip/源码）

你可以通过 ACP 命令快速配置环境：在 Health 视图中点击“Set up browser tools”按钮，即可一键运行 `hermes acp --setup-browser --assume-yes` 来安装 Chromium 并配置 Playwright。若需从源码构建，可以使用 Xcode 打开 `.xcodeproj` 文件，或通过命令行使用 `xcodebuild` 进行编译。对于没有 Apple Developer 账号的贡献者，推荐使用 `./scripts/local-build.sh` 进行本地 Debug 构建。

🚀 使用教程

快速上手指南：首先，在任何项目文件夹中创建 `.scarf/dashboard.json` 文件，用于定义自定义仪表盘的内容。你可以通过 JSON 配置不同的 `sections` 和 `widgets`（如 `stat` 或 `progress` 类型），从而实现对项目状态、测试覆盖率等关键指标的实时可视化监控，让项目进度一目了然。

⚙️ 配置说明（含 MCP / env）

Scarf 支持通过斜杠命令进行高级配置。使用 `/subgoal <text>` 可以为当前的 `/goal` 循环添加额外的成功标准，并支持通过 `remove N` 或 `clear` 进行管理。针对 MCP (Model Context Protocol) 服务，新增了 `supports_parallel_tool_calls` 可选标志，允许在编辑器中通过三态选择器进行配置。此外，`terminal.docker_extra_args` 参数可将额外参数原样转发给 `docker run` 命令。

🔌 API 说明

仪表盘 Schema 参考：Scarf 使用 JSON 格式定义仪表盘。每个 JSON 文件必须包含 `version` 和 `title` 字段，`description` 和 `updatedAt` 为可选字段。`sections` 数组定义了网格布局，每个 section 内可以包含多个 `widgets`，通过配置不同的类型和颜色，实现高度定制化的监控界面。

❓ FAQ 摘要

故障排除：如果连接指示灯显示为绿色，但 Dashboard 却显示“Stopped”、“unknown”或数值为空，通常是因为 SSH 用户缺乏读取 Hermes 状态文件的权限。此时，请前往 Manage Servers → Run Diagnostics，或点击工具栏中的黄色警告提示，运行内置的诊断程序，它将执行 14 项自动化检查以定位问题。

🎯 aiskill88 AI 点评 A 级 2026-05-20

高质量MCP工具实现，原生性能优异。多窗口架构设计合理，活跃维护，502星反映社区认可度良好。

📚 实用指南（长尾问题）
适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 做语音类 AI 产品的开发者
最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal
部署方案
  • Docker：scarf 提供官方镜像，docker compose up 一键启动
  • CLI：直接 npm install -g / pip install，命令行调用
  • 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
scarf 中文教程scarf 安装报错怎么办scarf MCP 配置scarf Docker 部署scarf Agent 工作流scarf 与同类工具对比scarf 最佳实践scarf 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 做语音类 AI 产品的开发者
⭐ 最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
⚠️ 常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • 容器内无法访问宿主机 localhost — 使用 host.docker.internal

👥 适合人群

AI 技术爱好者研究人员和学生开发者和工程师技术创业者

🎯 使用场景

  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发

⚖️ 优点与不足

✅ 优点
  • +MIT 协议，可免费商用
  • +完全开源免费，无授权费用
  • +本地部署，数据完全自主可控
  • +开发者社区支持，遇问题可查可问
⚠️ 不足
  • −安装和初始配置可能需要一定技术基础
  • −功能完整性通常不如成熟商业产品
  • −技术支持主要依赖开源社区，响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。

🔗 相关工具推荐

LlamaIndex 知识检索框架
LlamaIndex是领先的文档智能代理和OCR平台，专为构建AI应用而设计。提供数据连接、检索增强生成（RAG）等核心
AutoGPT 自主AI代理
AI工具
JavaGuide面试指南
AI工具
Hermes AI工作流引擎
AI工具
📚 相关教程推荐
MCP 配置教程
帮助中心 · AI Skill Hub
MCP 工具
帮助中心 · AI Skill Hub
Cursor AI 编程完全指南：Rules 配置、Composer 使用、MCP 集成
帮助中心 · AI Skill Hub
MCP 工作流生产级配置方案：从开发环境到团队共享
帮助中心 · AI Skill Hub
📰 相关 AI 新闻
AI Agent 自主化能力最新进展
AI 资讯 · 知识关联
GitHub热门：claude-mem — Persistent Context Across Sessions for Every Agent – Capt
AI 资讯 · 知识关联
OpenAI 最新产品与研究动态
AI 资讯 · 知识关联
AI Agent 自主化能力最新进展
AI 资讯 · 知识关联
🍿 AI 圈相关吃瓜
AutoGPT 自主完成了任务：把我的文件夹全部重命名了
AI 圈观察
配了5个 MCP 工具，Claude 一个都没用
AI 圈观察
Filesystem MCP 帮 Claude 找文件，找了整个 node_modules
AI 圈观察
🗺️ 相关解决方案
mcp
mcp-server-setup
agent
ai-agent-workflow
workflow
ai-workflow-templates
docker
docker-deploy
🧩 你可能还需要
基于当前 Skill 的能力图谱，自动补全的工具组合
客户支持聊天机器人
基于检索增强的全生产就绪AI客户支持系统
natively-cluely-ai-assistant — Claude Skill 中文使用文档
免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。
代码智能引擎
MCP · Agent · 工作流
AI公司多智能体操作系统
为Claude Code设计的开源MCP工具集，包含108个MCP工具和40+智能体模板。支持多智能体协作编排，提供完整的自主代理框架。适合
LEANN AI技能包
MCP · Agent · 工作流
香蕉幻灯片
Agent · 工作流 · 翻译

❓ 常见问题 FAQ

支持多服务器连接，兼容Hermes AI代理框架的各类后端服务。
💡 AI Skill Hub 点评

总体来看，scarf MCP工具 是一款质量优秀的AI工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

📚 深入学习 scarf MCP工具
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 scarf
原始描述 开源MCP工具：Native macOS and iOS App for the Hermes AI agent — multi-window, multi-server (l。⭐502 · Swift
Topics MCP工具AI代理macOS应用Swift开发多窗口管理
GitHub https://github.com/awizemann/scarf
License MIT
语言 Swift
🔗 原始来源
🐙 GitHub 仓库  https://github.com/awizemann/scarf 🌐 官方网站  https://awizemann.github.io/scarf/

收录时间：2026-05-16 · 更新时间：2026-05-19 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →