MCP DEEPwebresearch

🚀 MCP 深度项目

MCP 深度项目借助 Playwright 实现浏览器自动化操作，为开发者提供便捷的浏览器自动化解决方案，提高开发和测试效率。

🚀 快速开始

MCP 深度项目使用 Playwright 进行浏览器自动化操作。以下是项目的详细文档。

📦 安装指南

安装依赖项

pnpm install

构建项目

pnpm build

监控文件更改

pnpm watch

开发模式运行

pnpm dev

💻 使用示例

测试说明

运行所有测试

pnpm test

监控模式运行测试

pnpm test:watch

以覆盖率模式运行测试

pnpm test:coverage

代码质量检查

执行代码检查

pnpm lint

自动修复代码问题

pnpm lint:fix

进行类型检查

pnpm type-check

📚 详细文档

配置选项

项目可以通过环境变量进行配置：

错误处理

常见问题

1. 速率限制
   • 症状：出现“Too many requests”错误
   • 解决方案：增加 SEARCH_DELAY_MS 或降低 MAX_PARALLEL_SEARCHES
2. 网络超时
   • 症状：出现“Request timed out”错误
   • 解决方案：确保请求在 60 秒的 MCP 超时限制内完成
3. 浏览器问题
   • 症状：“Browser failed to launch” 错误
   • 解决方案：确保 Playwright 已正确安装（通过运行 npx playwright install）

调试方法

• 检查 Claude Desktop 的 MCP 日志：

  # 在 macOS 上
  tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  
  # 在 Windows 上
  Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait
  

• 启用调试日志：

  export LOG_LEVEL=debug
  

开发指南

项目设置

# 安装依赖项
pnpm install

# 构建项目
pnpm build

# 监控文件更改
pnpm watch

# 在开发模式下运行
pnpm dev

测试指南

# 运行所有测试
pnpm test

# 以监控模式运行测试
pnpm test:watch

# 以覆盖率模式运行测试
pnpm test:coverage

代码质量

# 执行代码检查
pnpm lint

# 自动修复代码问题
pnpm lint:fix

# 进行类型检查
pnpm type-check

贡献指南

1. 代码风格
   • 使用 VSCode 的默认 JavaScript/TypeScript 配色方案。
   • 禁止在文件中添加自动生成的版权声明。
2. 提交规范
   • 请参考项目仓库中的 CONTRIBUTING.md 文件。

相关链接

• Playwright 官网
• pnpm 官网

⚠️ 重要提示

此文档为 MCP 深度项目的参考指南，转载请注明出处。