Harie

@harie/mcp

English | 日本語

用于读取和写入 Harie 文件的本地 MCP 服务（stdio）：截图以普通 JPEG / PNG 图片的形式保存，标注（框、箭头、说明框、文字）在保存后仍可编辑。 它允许 Claude 等 MCP 客户端处理诸如“在保存按钮周围画一个红框”或“修改这个说明框的措辞”之类的请求。

Harie 是用于为 SaaS 用户指南中的截图添加标注的工具。Harie 文件可在任何图像查看器中作为普通图片打开，Harie 也可以反复重新打开文件并编辑标注。

该服务从不调用大模型。客户端的大模型会查看图片并决定要添加哪些标注；服务只负责读取、写入和渲染文件。

工具

工具	功能
harie_open	打开文件并返回其中的标注（以 JSON 格式返回，包括说明框文字）和图片。普通图片会返回 status: plain
harie_create	根据普通 JPEG / PNG 创建 Harie 文件（默认文件名为 <name>.harie.<ext>；保留原文件）。format（jpeg / png）用于选择输出格式
harie_preview	返回应用标注更改（ops）后的图片。文件不会被修改
harie_edit	应用标注更改、重新渲染并覆盖文件。expectedRevision 用于乐观锁定
harie_list	列出目录中的 Harie 文件
harie_mask	通过将个人信息永久绘制到基础图片中来隐藏信息（不可逆）。仅在 confirm: true 时保存；否则只返回遮盖后的图片
harie_replace_base	替换图片，同时保留标注（适用于屏幕内容已更改的情况）。如果尺寸不同，会缩放标注以适应新图片。不会保留旧图片中的遮盖；相关区域会作为 previousPii 返回

harie_open、harie_edit 和 harie_replace_base 可接受 image: false，以跳过图片并仅返回 JSON。图片会占用客户端的大量上下文，因此如果只需读取或改写文字，请使用此选项。

该服务只能访问 --root 指定目录下的文件（默认值：当前目录）。harie_mask 会重写基础图片，因此保存后无法撤销更改。若要保留原图，请使用 outPath 保存到另一个文件。

设置

需要 Node.js 22 或更高版本。使用 npx 从 npm 启动 @harie/mcp。

Claude Code

claude mcp add harie -- npx -y @harie/mcp --root ~/Pictures/guides

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "harie": {
      "command": "npx",
      "args": ["-y", "@harie/mcp", "--root", "/Users/you/Pictures/guides"]
    }
  }
}

从仓库运行（开发）

pnpm install
pnpm build   # produces apps/mcp/dist/index.mjs and dist/fonts/
claude mcp add harie -- node /path/to/harie/apps/mcp/dist/index.mjs --root ~/Pictures/guides

指南提示词（harie_guide）

该服务附带提示词 harie_guide（参数：path、可选的 intent），其中包含与 Web 编辑器的 AI 建议相同的规则：要突出显示哪些 UI 元素（只突出说明所需的内容，最多 8 个，并按操作顺序排列）、如何编写每个说明框（用 1–2 句话说明读者要做什么；绝不虚构功能或复制个人数据）、布局规则（每个步骤都要有一个框、一个数字徽章和一个箭头指向该框的说明框；徽章始终位于对应框的左上角外侧，且绝不遮挡 UI 元素；带有指向其框的 anchor 的徽章会自动放置在相应位置），以及使用这些工具时的操作步骤（打开 → 遮盖个人数据 → 添加框 + 数字徽章 + 锚定说明框 → 预览 → 保存）。在 Claude Code 中，它会显示为 /mcp__harie__harie_guide。相同规则的简短版本也会作为服务的 instructions 发送，因此即使客户端不读取提示词，也会遵循这些规则。

示例提示词

• “将 settings.png 转换为 Harie 文件，在保存按钮周围画一个红框，并添加一个写着‘点击此处保存’的说明框。”
• “列出 guides/ 中的 Harie 文件，并为所有没有标题的文件添加标题。”

工具描述目前优先使用日语。标注文字可以使用日语、英语、韩语、中文（简体和繁体）以及随附字体支持的其他语言。

开发

• src/tools.ts：工具实现。src/server.ts：MCP 注册和输入验证。src/paths.ts：防止访问根目录之外的内容。
• 测试（pnpm test）通过 SDK 的 InMemoryTransport 连接客户端，并实际调用工具。
• 此软件包包含 Noto Sans JP 的常规和粗体字重，以及 Noto Sans KR（韩文）和 Noto Sans SC（Noto Sans JP 缺少的字符）的子集；仅当注释使用这些字体时才会加载（scripts/copy-assets.mjs；许可证见 dist/fonts/OFL.txt）。

许可证

MIT。捆绑的字体（Noto Sans JP / KR / SC，常规 / 粗体）采用 SIL Open Font License 1.1 许可（dist/fonts/OFL.txt）。