fetchpet

Fetch Pet MCP サーバー

Playwright による自動操作を使用して、Fetch Pet の保険請求を管理する MCP サーバーです。請求を申請し、請求状況を追跡し、EOB や請求書を含む請求の詳細を確認できます。

機能

• 請求の準備 - 検証を行いながら請求フォームに入力します（送信はしません）
• 請求の送信 - 明示的なユーザー確認を得て、準備した請求を実際に送信します
• すべての請求の表示 - 1 回の呼び出しですべての請求（進行中および過去の請求）を確認できます
• 請求の詳細 - EOB や請求書のダウンロードなど、詳細情報を取得できます

ツール

ツール	説明
prepare_claim_to_submit	請求フォームを送信用に準備します（検証は行いますが、送信はしません）
submit_claim	準備した請求を送信します（ユーザー確認トークンが必要です）
get_claims	すべての請求（進行中／保留中および過去／完了済み）を取得します
get_claim_details	EOB や請求書のダウンロードなど、請求の詳細情報を取得します

セットアップ

前提条件

• Node.js 18+
• Fetch Pet アカウント（fetchpet.com で作成してください）

環境変数

変数	必須	説明	デフォルト
FETCHPET_USERNAME	はい	Fetch Pet アカウントのメールアドレス	-
FETCHPET_PASSWORD	はい	Fetch Pet アカウントのパスワード	-
HEADLESS	いいえ	ヘッドレスモードでブラウザーを実行します	true
TIMEOUT	いいえ	ブラウザー操作のタイムアウト（ms）	30000
FETCHPET_DOWNLOAD_DIR	いいえ	ダウンロードしたファイルの保存先ディレクトリ	/tmp/fetchpet-downloads

Claude Desktop

Fetch Pet アカウントのログイン情報を用意してください。

その後、以下のセットアップ手順に進みます。MCP サーバーを初めて使用する場合は、Claude Desktop アプリケーションを用意し、公式の MCP セットアップ手順に従ってください。

手動セットアップ

ターミナルで npx コマンドを実行できるよう、マシンに Node をインストールする必要があります。Node がインストールされていない場合は、nodejs.orgからインストールできます。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json ファイルを編集して、以下を追加してください。

{
  "mcpServers": {
    "fetchpet": {
      "command": "npx",
      "args": ["-y", "fetchpet-mcp-server"],
      "env": {
        "FETCHPET_USERNAME": "[email protected]",
        "FETCHPET_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop を再起動すれば、準備完了です。

使用例

新しい請求を申請する

"Submit a claim for my dog Buddy - I have an invoice from Test Vet Clinic for $150 dated January 15th for an annual checkup"

アシスタントは次の操作を行います。

1. prepare_claim_to_submit を使ってフォームに入力します
2. 送信される内容を正確に表示します
3. 明示的な確認を求めます
4. その後に限り、確認トークンを指定して submit_claim を呼び出します

請求を表示する

"Show me my active claims"
"What claims are pending?"
"Show my claim history"
"What's the status of my recent claims?"

請求の詳細を取得する

"Get details for claim ABC123"
"Download the EOB for my last claim"
"Show me the invoice for that claim"

仕組み

この MCP サーバーは Playwright を使用して Fetch Pet のブラウザーセッションを自動操作します。

1. サーバー起動時：バックグラウンドでブラウザーを起動し、Fetch Pet アカウントにログインします
2. ブラウザーセッションの維持：以降のすべてのツール呼び出しで、同じログイン済みセッションを再利用します
3. スマートナビゲーション：必要に応じて、ツールが適切なページに移動します
4. ステルスモード：bot 検出を回避するため、ステルスプラグインを備えた playwright-extra を使用します

請求申請の安全性

請求申請のプロセスは、安全性を考慮して設計されています。

1. prepare_claim_to_submit はフォームに入力し、すべての項目を検証しますが、送信ボタンはクリックしません
2. 一意の確認トークンを返します
3. submit_claim ではこのトークンが必要となるため、ユーザーによる明示的な確認が保証されます
4. 正しいトークンがないと、請求を送信できません

開発

# Install dependencies
npm run install-all

# Run in development mode
npm run dev

# Build
npm run build

# Run tests
npm test

# Run integration tests
npm run test:integration

# Run manual tests (requires real credentials)
npm run test:manual

# Lint
npm run lint

プロジェクト構成

fetchpet/
├── local/                 # Local server implementation
│   └── src/
│       └── index.ts       # Entry point with env validation
├── shared/                # Shared business logic
│   └── src/
│       ├── server.ts      # FetchPetClient with Playwright automation
│       ├── tools.ts       # MCP tool definitions
│       ├── types.ts       # TypeScript types
│       └── logging.ts     # Logging utilities
├── tests/                 # Test suites
├── package.json           # Root workspace config
└── README.md

セキュリティに関する注意事項

• Fetch Pet の認証情報は、アカウントへのログインにのみ使用されます
• ブラウザーセッションは、お使いのマシン上でローカルに実行されます
• 認証情報がサードパーティのサービスに送信されることはありません
• 認証情報をハードコードするのではなく、環境変数を使用することを検討してください
• ダウンロードした書類（EOB、請求書）は、設定したダウンロードディレクトリに保存されます

制限事項

• 有効な Fetch Pet アカウントが必要です
• Fetch Pet がウェブサイトを更新すると、ブラウザーの自動操作が失敗する場合があります
• ページ間の移動が必要な操作には時間がかかります
• ウェブサイトは React アプリを使用しているため、動的コンテンツの読み込みには待機が必要な場合があります

ライセンス

MIT