MCP DEEPwebresearch

🚀 MCP 深度任務

MCP 深度任務是一款專為 Claude 平臺內部打造的工具，可執行復雜多步驟操作。它具備並行搜索、網頁訪問和內容提取等功能，尤其適合從多個來源獲取信息的任務。

🚀 快速開始

本項目通過環境變量配置服務器，以下是各環境變量的說明及默認值：

✨ 主要特性

功能模塊

並行搜索 (parallel_search)

• 功能：執行多個 Google 搜索，並通過智能隊列實現高效處理。
• 參數：{ queries: string[], maxParallel?: number }
• 限制：maxParallel 最大為 5，以保證系統穩定性。

網頁訪問 (visit_page)

• 功能：訪問指定網頁並提取內容。
• 參數：{ url: string }
• 返回值：

{
  url: string;
  title: string;
  content: string; // Markdown 格式的內容
}

📚 詳細文檔

錯誤處理

常見問題

1. 速率限制
   • 症狀："Too many requests" 錯誤
   • 解決方法：增加 SEARCH_DELAY_MS 或減少 MAX_PARALLEL_SEARCHES
2. 網絡超時
   • 症狀："Request timed out" 錯誤
   • 解決方法：確保請求在 MCP 的 60 秒超時限制內完成
3. 瀏覽器問題
   • 症狀："Browser failed to launch" 錯誤
   • 解決方法：確保 Playwright 已正確安裝 (npx playwright install)

調試指南

1. 查看 Claude 平臺的 MCP 日誌：

# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows
Get-Content -Path "$env:APPDATA\Claude\logs\mcp*.log" -Tail 20 -Wait

2. 啟用調試日誌：

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. Fork 倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 提交 Pull Request

編碼規範

• 遵循 TypeScript 最佳實踐
• 維持 80% 的代碼覆蓋率
• 確保提交信息的可讀性

項目依賴

• Playwright：用於瀏覽器自動化和網絡請求
• pnpm：模塊管理工具

📄 許可證

本項目遵循 MIT 協議。

通過以上內容，您可以全面瞭解 MCP 深度任務的功能、配置和使用方法。如需進一步幫助，請參考相關文檔或聯繫支持團隊。