🚀 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 深度任务的功能、配置和使用方法。如需进一步帮助，请参考相关文档或联系支持团队。