MCP 深度

项目介绍

MCP 深度是一个用于执行复杂网络任务和搜索操作的工具，支持并行搜索、网页访问和内容提取等功能。以下是详细文档。

功能概述

核心功能

1. 深度搜索

   • 执行多个 Google 搜索
   • 支持智能队列管理
   • 最大并行搜索数限制为 5，以确保稳定性能

2. 网页访问

   • 访问指定 URL 并提取内容
   • 返回格式化的 Markdown 格式文本

使用说明

深度搜索接口

{
  type: 'parallel_search';
  args: {
    queries: string[];
    maxParallel?: number;
  };
}

返回结果示例：

[
  {
    query: "查询词1";
    results: [
      { url: "链接1", title: "标题1", snippet: "摘录1" },
      // 其他结果...
    ]
  },
  // 多个查询的结果...
]

网页访问接口

{
  type: 'visit_page';
  args: { url: string };
}

返回结果示例：

{
  url: "https://example.com",
  title: "示例页面标题",
  content: "# 示例内容\n 这是网页的正文内容..."
}

配置选项

通过环境变量进行配置：

• MAX_PARALLEL_SEARCHES - 最大并行搜索数，默认为5
• SEARCH_DELAY_MS - 搜索之间的延迟，以毫秒为单位，默认200ms
• MAX_RETRIES - 请求重试次数，默认3次
• TIMEOUT_MS - 请求超时时间，以毫秒为单位，默认55000ms
• LOG_LEVEL - 日志级别，默认'info'

错误处理

常见问题

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）

开发信息

项目设置

# 安装依赖
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. 创建功能分支

   git checkout -b feature/amazing-feature
   

2. 提交更改

   git commit -m '新增神奇功能'
   

3. 推送到远程仓库

   git push origin feature/amazing-feature
   

4. 提出合并请求

编码规范

• 遵循TypeScript最佳实践
• 维护80%以上的测试覆盖率
• 文档清晰，便于理解
• 确保代码可维护性

版权信息

本项目由[你的姓名/公司]开发和维护，遵循MIT许可证。

此文档涵盖了MCP深度工具的主要功能、使用方法及开发指南。如需进一步帮助，请参考官方文档或联系支持团队。