🚀 MCP 深度
MCP 深度是一款强大的工具，可用于执行复杂网络任务与搜索操作。它支持并行搜索、网页访问和内容提取等功能，能有效提升网络信息获取的效率和质量。
🚀 快速开始
MCP 深度可用于执行复杂网络任务和搜索操作，支持并行搜索、网页访问和内容提取等功能。你可以按照后续文档进行配置和使用。
✨ 主要特性
核心功能
- 深度搜索
- 可执行多个 Google 搜索。
- 支持智能队列管理。
- 最大并行搜索数限制为 5，确保稳定性能。
- 网页访问
- 能访问指定 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'。
错误处理
常见问题
- 速率限制
- 症状："Too many requests" 错误。
- 解决方案：增加
SEARCH_DELAY_MS或减少MAX_PARALLEL_SEARCHES。
- 网络超时
- 症状："Request timed out" 错误。
- 解决方案：确保请求在 60 秒的 MCP 超时限制内完成。
- 浏览器问题
- 症状："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
🤝 贡献指南
- 创建功能分支
git checkout -b feature/amazing-feature
- 提交更改
git commit -m '新增神奇功能'
- 推送到远程仓库
git push origin feature/amazing-feature
- 提出合并请求
编码规范
- 遵循 TypeScript 最佳实践。
- 维护 80% 以上的测试覆盖率。
- 文档清晰，便于理解。
- 确保代码可维护性。
📄 许可证
本项目由[你的姓名/公司]开发和维护，遵循 MIT 许可证。
此文档涵盖了 MCP 深度工具的主要功能、使用方法及开发指南。如需进一步帮助，请参考官方文档或联系支持团队。