快速结论
Grep by Vercel 是 Vercel 运营的公共代码搜索服务；它的官方远程 MCP 入口是 https://mcp.grep.app。MCP 暴露 searchGitHub 工具，让兼容客户端在百万级公开 GitHub 仓库中查找真实代码片段，并按仓库、路径和语言缩小范围。它最适合回答“这个 API 在真实项目里怎么写”“某种配置通常放在哪里”这类需要代码证据的问题，不是通用网页搜索、私有仓库搜索或代码生成模型。
截至 2026-07-21，网页搜索和官方 MCP 可免费使用，MCP 初始化与工具发现不要求账号或 API Key。不过，免费不代表生产承诺：Grep 条款明确按现状提供服务，不保证准确性、可用性或持续支持，也没有公开 SLA。本站不默认推荐把它放进关键流水线，尤其不能把“官方 MCP 可调用”理解为允许批量抓取、建立镜像或绕过限制。
核心功能
- 字面代码模式搜索：
searchGitHub面向会真实出现在文件中的字符串或正则表达式，例如useState(、getServerSession或跨行清理模式，而不是“React 最佳实践”这样的自然语言主题。 - 结构化过滤：可设置大小写、整词和正则匹配，并按
owner/repo、文件路径或编程语言过滤结果。 - 公开仓库样例：返回仓库、分支、路径、匹配片段和行号上下文，便于回到原仓库核对完整实现。
- 官方远程 MCP：兼容 Streamable HTTP 的客户端可直接配置
https://mcp.grep.app，不必安装本地索引器。 - 网页与 API 搜索面：
grep.app可供人工检索；MCP 更适合在受控的 Agent 工作流里发起单次、目的明确的查询。 - 只读参考能力：它检索 Vercel 已索引的公开代码，不读取本地工作区，也不提供私有仓库索引、代码修改、执行或仓库写入工具。
适合人群
- 使用陌生 SDK 的开发者：需要从多个公开项目核对调用参数、导入路径和错误处理方式。
- MCP 客户端用户：希望让 Claude Code、Cursor 或其他兼容客户端补充公开代码证据。
- 代码评审者与技术作者：需要定位真实实现，再回到上游仓库阅读上下文与许可。
- 不适合的人群：需要搜索企业私有代码、要求可用性 SLA、要批量复制索引，或希望搜索结果可以不经许可证审查直接并入产品的团队。
使用场景
查 API 用法时，应把查询写成最小、独特的代码形态，并用语言或仓库过滤减少噪声。例如搜索函数名加左括号通常比输入一整句问题更有效。找到候选结果后，打开原仓库确认依赖版本、上下文、测试和最近提交；搜索片段只能证明“有人这样写过”，不能证明该写法正确、安全或仍受支持。
Agent 接入应保持窄范围。允许模型按具体任务查询几次，记录引用并让人复核；不要让无人值守循环穷举关键词、遍历仓库、抓取全部结果或重建 Grep 数据集。若任务涉及自家未公开实现，不要把专有函数、客户标识、漏洞细节、密钥或大段私有源码放进查询，因为查询本身会作为 Input 发送给 Vercel。
价格与版本
| 形态 | 当前价格 | 主要边界 |
|---|---|---|
| Grep Web | 免费 | 人工搜索公开 GitHub 代码 |
| 官方 Grep MCP | 免费 | 通过 https://mcp.grep.app 调用 searchGitHub；当前无需第三方平台密钥 |
Vercel 没有为 Grep 公布付费层、固定配额或 SLA。条款允许 Vercel修改、暂停或终止全部或部分服务，也不承诺结果完整、无错误或适合特定用途。因此，自动化流程需要超时、退避、失败降级和人工核验，不能把免费端点当作永久、无限或有赔偿责任的企业 API。
国内访问与使用体验
Grep 与官方 MCP 是海外托管服务，中国大陆网络下可能出现连接、TLS、流式响应或结果加载不稳定，因此标记 needsVPN: true。这只是可达性元数据，不代表任何网络服务建议。团队应在实际办公网络和目标 MCP 客户端中测试连接，并避免因失败自动高频重试。
查询隐私比连接方式更重要。Grep 条款把搜索查询定义为 Input，可能包含代码片段、提示或其他信息；用户授予 Vercel 使用 Input 以提供、维护、开发和改进服务的许可。Vercel 隐私政策还说明会处理使用、设备、日志、IP 和搜索等数据。不要提交密钥、未公开漏洞、客户数据、受保密义务约束的代码或可识别内部项目的信息。若组织有数据驻留、删除、保留或审计要求，应先向 Vercel取得明确的合同答案，而不是从“无需登录”推断匿名或不留存。
优点
- 官方远程 MCP 入口简单，不需要本地构建和维护公共代码索引。
- 搜索参数围绕代码模式设计，仓库、路径和语言过滤适合开发任务。
- 结果指向真实公开仓库，可作为文档之外的实现线索。
- 当前免费，适合低频、人工监督的研究与开发辅助。
- 工具只读且范围明确，比具有终端或仓库写权限的 MCP 更容易限制风险。
不足
- 只覆盖已索引的公开 GitHub 仓库，不搜索私有仓库、本地代码或完整互联网。
- 字面搜索依赖查询设计，不是理解意图的语义代码搜索；结果可能过时、错误或脱离上下文。
- Grep 服务软件是 Vercel 的专有服务，公开可访问不等于开源或可复制部署。
- 免费服务没有公开 SLA、稳定配额、支持周期或持续提供承诺。
- 查询会发送给 Vercel，敏感代码和内部标识不适合用于搜索词。
- 自动化访问受条款限制，不能用 MCP 名义进行批量挖掘、绕过速率限制或建立竞争性索引。
替代品对比
| 工具 | 更适合谁 | 主要差异 |
|---|---|---|
| GitHub MCP Server | 需要访问获授权 GitHub 仓库、Issue 和 PR 的团队 | 能处理账户授权范围内的 GitHub 数据与操作，权限面远大于公开只读搜索 |
| Context7 | 需要当前库文档与版本化示例的开发者 | 重点是文档上下文，不是跨公开仓库的字面代码检索 |
| Exa | 需要通用网页研究与语义检索的 Agent | 搜索范围更广，代码路径、语言和正则过滤不是核心 |
| GitHub Copilot | 需要补全、对话和 Agent 执行的开发者 | 是完整开发助手；Grep 只提供外部公开代码搜索证据 |
常见问题 FAQ
Grep by Vercel 是官方 MCP 吗？
是。官方远程入口为 https://mcp.grep.app，可初始化 MCP 会话并发现 searchGitHub 工具。无需经过第三方 MCP 市场。
当前需要 API Key 或付费订阅吗？
截至 2026-07-21，官方 MCP 可免费连接，初始化和工具发现未要求 API Key。但 Vercel 没有承诺永久免费、无限调用或固定配额。
可以搜索私有 GitHub 仓库或本地代码吗？
不可以。该工具面向 Vercel 索引的公开 GitHub 仓库。私有代码应使用经过组织授权、具有明确数据处理条款的内部搜索方案。
搜索查询会保持私密吗？
不要作此假设。查询作为 Input 提交给 Vercel，相关条款允许其为提供、维护、开发和改进服务而使用 Input。敏感信息不应进入查询。
搜索到的代码可以直接复制进商业项目吗？
不一定。每个结果仍受原仓库许可证约束，Vercel 不授予这些第三方代码的使用权。复制前要查看原文件和仓库许可证，并核对版权声明、版本与依赖。
可以让 Agent 持续抓取 Grep 结果做自己的数据集吗？
不能从 MCP 可用性推导出这种权利。Grep 条款限制未经授权的自动化访问、内容挖掘、保护措施绕过和服务再分发；批量用途应先取得 Vercel书面授权。
总结
Grep by Vercel 的价值很窄也很实用：通过官方 MCP，把公开 GitHub 中的真实代码模式带进开发对话。正确用法是小范围查询、返回原仓库核验、遵守每个来源的许可证，并把输出当线索而不是答案。它当前免费，但属于专有、无公开 SLA 的托管服务；查询隐私和自动化权限也有明确边界。适合非敏感、低频、有人监督的代码研究，不适合私有代码搜索、批量数据采集或关键生产依赖。