fetchpet

Fetch Pet MCP 服务

使用 Playwright 自动化管理 Fetch Pet 保险理赔的 MCP 服务。提交理赔申请、跟踪理赔状态，并查看包括 EOB 和发票在内的理赔详情。

功能

• 准备理赔申请 - 填写理赔表单并进行验证（不提交）
• 提交理赔申请 - 在用户明确确认后，实际提交已准备好的理赔申请
• 查看所有理赔申请 - 通过一次调用查看所有理赔申请（当前和历史）
• 理赔详情 - 获取详细信息，包括 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	否	浏览器操作超时时间（毫秒）	30000
FETCHPET_DOWNLOAD_DIR	否	保存下载文件的目录	/tmp/fetchpet-downloads

Claude Desktop

请准备好 Fetch Pet 账号凭据。

然后按照下方的设置说明操作。如果这是你第一次使用 MCP 服务，请确保已安装 Claude Desktop 应用程序，并按照 MCP 官方设置说明操作。

手动设置

你需要在计算机上安装 Node，以便在终端中运行 npx 命令。如果尚未安装 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. 隐身模式：使用带有隐身插件的 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