mcpField
F
familiar-mcp

familiar-mcp

本地服务
github.com浏览器自动化118 周前更新
代码仓库访问官网

关于 familiar-mcp

familiar-mcp 是 TypeScript MCP 服务，通过 AppleScript 控制 macOS 上用户实际使用的 Google Chrome。它提供 32 项按标签页操作的浏览器动作，用于导航、页面检查和交互；使用日常浏览器，而非 DevTools Protocol 或 Playwright。

主要功能

  1. 01通过 AppleScript 控制 Chrome
  2. 02管理标签页和导航
  3. 03等待页面及选择器条件
  4. 04读取页面内容和元素值
  5. 05操作表单与页面元素
  6. 06在页面中运行 JavaScript

适用场景

  1. 01自动化现有 Chrome 会话中的任务
  2. 02检查页面内容和 DOM 元素
  3. 03填写并提交浏览器表单
  4. 04处理需要普通浏览器的页面

MCP 相关

MCP 服务向兼容客户端开放相同的 32 项浏览器操作，包括 Claude Code、Claude Desktop、Cursor 和 Codex CLI。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dominion525-familiar": {
      "command": "npx",
      "args": [
        "-y",
        "@dominion525/familiar-mcp"
      ]
    }
  }
}
启动命令npx -y @dominion525/familiar-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@dominion525/familiar-mcp0.1.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

familiar

通过 AppleScript 控制你真实的 macOS Chrome——无需 DevTools Protocol 或 Playwright。

一个通过 AppleScript（Apple Events）驱动 macOS 上 Google Chrome 的 Claude Code 技能。它使用你日常使用的浏览器，而不是无头或自动化浏览器，因此，受到机器人/WAF 防护的网站往往会将其视为普通用户。

日语版请参阅 README.ja.md。

功能

所有操作都限定于特定标签页（windowId + tabId）；绝不依赖“活动标签页”。

  • list_tabs / new_tab / new_incognito_tab / close_tab — 标签页管理（new_tab 使用普通窗口，new_incognito_tab 使用隐身窗口）
  • active_tab / window_mode / is_loading — 检查活动标签页、窗口模式和标签页加载状态
  • navigate / get_tab_url — 导航
  • reload / go_back / go_forward / stop — 历史记录与重新加载控制
  • wait_for_load / wait_for_selector / wait_for_function — 等待页面加载、元素出现或 JS 条件满足
  • get_html — 将当前 DOM 作为 HTML 获取
  • get_text / get_attribute / get_value / exists / query_all — 读取元素文本、属性、值、是否存在及所有匹配项
  • click / fill / clear / select_option / set_checked / press_key / submit / scroll_into_view — 与元素和表单交互
  • execute_js / execute_js_file — 执行任意 JavaScript（复杂脚本请使用文件形式）

选择器支持 CSS（默认）、text=、xpath= 和 label= 形式。

前提条件

  • 安装了 Google Chrome 的 macOS
  • 启用 Chrome 的“允许来自 Apple Events 的 JavaScript” （View → Developer → Allow JavaScript from Apple Events）
  • 首次运行时，在自动化权限提示中批准授权

安装

Claude Code 插件
/plugin marketplace add dominion525/familiar
/plugin install familiar@familiar

本地开发/测试：

/plugin marketplace add /path/to/familiar
/plugin install familiar@familiar
Vercel Skills（agent-skills）
npx skills add dominion525/familiar

这会将技能放在 ~/.agents/skills/familiar/ 下。任何遵循 agent-skills 规范 的客户端（Claude Code、Cursor 等）都会自动识别它。注册表位于 https://skills.sh。

MCP 服务

mcp/ 目录包含 MCP 服务的实现（TypeScript），可向任何兼容 MCP 的客户端（Claude Code、Claude Desktop、Cursor、Codex CLI 等）提供相同的 32 项操作。

快速安装（Claude Code）：

claude mcp add familiar -- npx @dominion525/familiar-mcp@latest

各客户端的完整安装和配置说明，请参阅 mcp/README.md。

独立运行（无需安装）

此脚本也可以独立运行，无需安装技能：

osascript skills/familiar/familiar.applescript list_tabs

完整用法请参阅 skills/familiar/SKILL.md。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。