使用说明（Markdown 格式）

项目简介
- Browse2MCP 是一个从浏览器记录的 API 流量出发，分析並生成基于 Model Context Protocol (MCP) 的服务器实现的工具。它可以处理 REST 与 GraphQL 端点、自动识别并注册工具、实现对话式上下文服务，并可选集成到 Claude Desktop 等 MCP 客户端中使用。
主要功能点
- 记录阶段：通过浏览器记录网站的 API 请求与响应，支持 REST 和 GraphQL，自动检测认证模式并提取会话中的示例数据。
- 生成阶段：基于记录数据分析端点、生成一个 MCP 服务器实现的代码（包含一个工具对应一个端点），并可选输出为一个完整的项目结构（包含 package.json、tsconfig.json 等）。
- 服务器实现：生成的服务器使用 MCP SDK，注册工具、处理 GraphQL/REST 请求，支持按需要自动化令牌持久化、登录工具，以及基本的令牌持久化、环境变量和可选的深合并默认值。
- 认证与令牌：自动检测并在生成的服务器中内置令牌获取策略（持久化文件、环境变量、已捕获令牌等优先级），并提供 login 工具以重新获取令牌。
- Claude Desktop 集成：生成的服务器可被 Claude Desktop 自动配置并使用。
- 开发者友好：提供 CLI（record、generate）、测试用例、以及用于将分析结果转为可运行服务器的完整流水线。
安装步骤
- 克隆仓库并安装依赖
  - git clone https://github.com/danielthedm/browse2mcp.git
  - cd browse2mcp
  - npm install
  - npx playwright install chromium
- 记录会话
  - npx tsx bin/browse2mcp.ts record https://app.example.com -o my-session.json
- 生成 MCP 服务器
  - npx tsx bin/browse2mcp.ts generate my-session.json -o my-mcp --name my-server --full
- 运行生成的 MCP 服务器（生成 full 项目后）
  - 进入输出的目录，安装依赖、编译并启动服务器（通常通过 npm install、npm run build、npm run start 等流程，具体请参考生成时的输出信息）
- 连接到 Claude Desktop（可选）
  - 如果采用自动配置，Claude Desktop 将提示添加生成的服务器；也可以手动将生成的服务器配置加入到 Claude Desktop 配置中。
服务器配置（MCP 客户端需要的最低启动信息）说明：MCP 客户端在连接服务器时，需提供服务器的启动命令及参数。下面是基于本仓库生成的典型配置结构示例，请以实际生成的服务器为准。
- serverName: my-mcp-server
- command: node
- args: ["dist/server.js"]
注释：该配置表示在 MCP 客户端中要启动服务器服务所用的命令与参数。serverName 为服务器标识，command 指定启动命令，args 为传递给命令的参数。这些信息来自浏览器记录并生成的 MCP 服务器代码，需要用户在 Claude Desktop 等客户端中按此格式填写以建立连接。
基本使用方法
- 使用 Browse2MCP 进行记录 → 生成 → 启动服务 → 使用 MCP 客户端进行自然语言调用端点
- 生成后的服务器默认支持 REST/GraphQL 的工具调用，具备令牌持久化、login 助手、以及基本的上下文渲染能力，方便与 LLM 客户端协作。

Browse2MCP

服务器信息