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 深度項目的參考指南，轉載請註明出處。