MCP DEEPwebresearch

🚀 MCP 深度任务

MCP 深度任务是一款强大的工具，可在 Claude 平台内部执行复杂多步骤操作。它具备并行搜索、网页访问和内容提取等功能，能高效地从多个来源获取信息，为用户提供便捷的信息整合服务。

🚀 快速开始

MCP 深度任务可在 Claude 平台内部直接使用，通过配置环境变量和调用相应功能模块，即可开展复杂多步骤操作。

✨ 主要特性

• 并行搜索：可同时执行多个 Google 搜索，利用智能队列实现高效处理。
• 网页访问：能访问指定网页并提取内容，以 Markdown 格式返回。
• 灵活配置：通过环境变量可灵活配置服务器参数，如并行搜索数量、搜索延迟等。
• 错误处理：针对常见问题，如速率限制、网络超时、浏览器问题等，提供了相应的解决方法。

📦 安装指南

项目搭建

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 监控文件变化
pnpm watch

# 开发模式运行
pnpm dev

测试

# 执行所有测试
pnpm test

# 监控测试
pnpm test:watch

# 带覆盖的测试
pnpm test:coverage

代码质量

# 运行代码检查工具
pnpm lint

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

# 类型检查
pnpm type-check

💻 使用示例

基础用法

// 并行搜索示例
import { parallel_search } from 'mcp-deep-task';

const queries = ['example query 1', 'example query 2'];
const result = await parallel_search({ queries });
console.log(result);

// 网页访问示例
import { visit_page } from 'mcp-deep-task';

const url = 'https://example.com';
const pageContent = await visit_page({ url });
console.log(pageContent);

高级用法

// 自定义并行搜索参数
import { parallel_search } from 'mcp-deep-task';

const queries = ['example query 1', 'example query 2', 'example query 3'];
const maxParallel = 3;
const result = await parallel_search({ queries, maxParallel });
console.log(result);

📚 详细文档

功能模块

并行搜索 (parallel_search)

• 功能：执行多个 Google 搜索，并通过智能队列实现高效处理。
• 参数：{ queries: string[], maxParallel?: number }
• 限制：maxParallel 最大为 5，以保证系统稳定性。

网页访问 (visit_page)

• 功能：访问指定网页并提取内容。
• 参数：{ url: string }
• 返回值：

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

配置选项

通过环境变量配置服务器：

🔧 技术细节

MCP 深度任务主要依赖 Playwright 进行浏览器自动化和网络请求，使用 pnpm 作为模块管理工具。通过配置环境变量，可灵活调整服务器参数，以适应不同的使用场景。同时，项目采用 TypeScript 编写，遵循 TypeScript 最佳实践，确保代码的可读性和可维护性。

🔧 错误处理

常见问题

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% 的代码覆盖率
• 确保提交信息的可读性

📄 许可证

本项目遵循 MIT 协议。

通过以上内容，您可以全面了解 MCP 深度任务的功能、配置和使用方法。如需进一步帮助，请参考相关文档或联系支持团队。