mcpField
F
familiar-mcp

familiar-mcp

ローカル
github.comブラウザ自動化118 週間前に更新
リポジトリ公式サイト

familiar-mcp について

familiar-mcp は、AppleScript を介して macOS 上の実際の Google Chrome を操作する TypeScript 製 MCP サーバーです。タブ単位のブラウザー操作を 32 種提供し、DevTools Protocol や Playwright ではなく普段使いのブラウザーで、ページ移動、確認、操作を行います。

主な機能

  1. 01AppleScript による Chrome 操作
  2. 02タブとページ移動の管理
  3. 03ページやセレクター条件の待機
  4. 04ページ内容と要素値の取得
  5. 05フォームや要素の操作
  6. 06ページ内での JavaScript 実行

活用シーン

  1. 01既存の Chrome セッションでの作業自動化
  2. 02ページ内容と DOM 要素の確認
  3. 03ブラウザーフォームの入力と送信
  4. 04通常のブラウザーを要するページの操作

MCP 対応

MCP サーバーは、Claude Code、Claude Desktop、Cursor、Codex CLI などの MCP クライアントに、同じ 32 種のブラウザー操作を公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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 を許可」を有効にします （表示 → デベロッパー → Apple Events からの JavaScript を許可）
  • 初回実行時に表示されるオートメーションの許可ダイアログを承認します

インストール

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/ ディレクトリには、同じ 32 のアクションを、MCP 互換クライアント（Claude Code、Claude Desktop、Cursor、Codex CLI など）で利用できるようにする MCP サーバー実装（TypeScript）が含まれています。

クイックインストール（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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。