关于 Parallel Search
Parallel Search MCP 是 Parallel 提供的托管式远程 MCP 服务,为编码 Agent 提供实时网页搜索与网页内容读取。基础使用无需账户或 API Key,适合查阅文档、核实信息的个人与小型项目。
主要功能
- 01web_search 返回相关摘要与来源链接
- 02web_fetch 读取指定 URL 的页面内容
- 03匿名接入,无需账户或 API Key
- 04支持 Codex、Gemini CLI、OpenCode、Cursor 等客户端
- 05认证连接可配置搜索模式与域名过滤
适用场景
- 01让编码 Agent 查找官方文档并引用来源
- 02核实最新软件版本与发布说明
- 03阅读指定网页并解释其内容
MCP 相关
该项目是一个远程 MCP 服务,通过 Streamable HTTP 接入 https://search.parallel.ai/mcp,向 MCP 客户端提供 web_search 与 web_fetch 工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://search-mcp.parallel.ai/mcpclaude mcp add --transport http parallel https://search-mcp.parallel.ai/mcp{"mcpServers":{"parallel":{"type":"http","url":"https://search-mcp.parallel.ai/mcp"}}}在 Cursor 中打开{"servers":{"parallel":{"type":"http","url":"https://search-mcp.parallel.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"parallel":{"type":"http","url":"https://search-mcp.parallel.ai/mcp"}}}{"mcpServers":{"parallel":{"serverUrl":"https://search-mcp.parallel.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| objective | string | 是 | 用自然语言描述网络搜索要查找的内容。 尽量将搜索目标设为单一具体的信息点。可包含首选来源或时效性方面的要求。 |
| search_queries | array | 是 | 简洁的关键词搜索查询,每条 3–6 个词,可包含搜索运算符。至少需要一条查询;为获得最佳结果,请提供 2–3 条。对于宽泛任务,可在一次调用中加入多个相关查询,而不是连续调用 web_search。查询应与目标相关。 |
| session_id | string | 否 | 当前对话的稳定标识符。在会话开始时生成一个随机值(UUID 或 32 位以上的十六进制字符串),并在每次 web_search / web_fetch 调用中重复使用完全相同的值。不同轮次之间不得更改。用于免费层速率限制以及关联日志中的工具调用;付费层密钥会忽略此值。 |
| model_name | string | 否 | 发起此工具调用的大模型标识符(例如 'claude-opus-4.7'、'gpt-5.5'、'gemini-2.5-pro')。首次调用前,请从可信的运行时/会话元数据或当前客户端配置中核实准确的活动模型标识。原样传递完整标识;切勿缩短或替换为 'gpt-5' 之类的模型系列别名。此值仅用于产品分析,不会影响搜索行为。 |
详细介绍
Parallel Search MCP
为你的编码 Agent 提供免费的网络搜索。
无需离开 Agent,即可查找最新文档、核实事实并阅读网页。无需账号或 API 密钥即可开始使用。
让你的 Agent 安装
将以下内容复制到你的编码 Agent 中:
Install Parallel's free Search MCP in the coding agent I'm using now.
Identify your client and use its native MCP setup instructions:
https://docs.parallel.ai/integrations/mcp/search-mcp
Server name: parallel-search
Server URL: https://search.parallel.ai/mcp
Transport: Streamable HTTP
Authentication: none. No account, API key, or Parallel CLI is needed.
Preserve existing settings and reuse any connection to this endpoint.
Tell me if a restart or approval is required.
Once connected, check that web_search and web_fetch are available.
Use Parallel to find the official FastAPI response-model documentation
and return a source link. Report anything you couldn't verify.
在 Cursor 中安装 · 在 VS Code 中安装 · 手动设置 · 文档
手动设置
选择你的客户端。你只需选择以下一种方式。
Codex
codex mcp add parallel-search --url https://search.parallel.ai/mcp
启动新的 Codex 会话,并运行 /mcp 检查连接。配置选项请参阅 Codex MCP 指南。
Gemini CLI
gemini extensions install https://github.com/parallel-web/search-mcp
重启 Gemini CLI,并运行 /mcp 检查 parallel-search 是否已连接。该扩展使用 Streamable HTTP,无需 Parallel 账号或 API 密钥。如果你已手动配置 parallel-search,则该配置优先于扩展。安装和更新选项请参阅扩展指南。
Hermes Agent
Hermes 已在其原生网络提供商中集成 Parallel。在 hermes tools 中选择 Parallel Free (keyless) 即可使用该集成。
这个可选软件包可直接连接到 Parallel 的 MCP 工具,并包含设置技能。它不会改变 Hermes 的原生网络提供商选择。可在 Hermes 插件目录中找到。使用以下命令安装并启用:
hermes plugins install parallel-search
hermes plugins enable parallel-search
启动新会话,让 Hermes 加载已启用的软件包。让 Hermes 使用 Parallel MCP 的 web_search 工具查找官方文档,然后使用 web_fetch 阅读页面。使用 skills_list 查找命名空间下的 parallel-search-setup 技能。无需 Parallel 账号、API 密钥或 CLI。
请使用此软件包,或手动配置连接到 https://search.parallel.ai/mcp,以避免出现重复的 MCP 工具。使用 hermes plugins disable parallel-search 停用软件包,或使用 hermes plugins remove parallel-search 将其移除。使用 hermes plugins update parallel-search 更新;目录更新采用经过审核的提交固定版本。
OpenCode
将以下内容合并到项目的 opencode.json 中:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"parallel-search": {
"type": "remote",
"url": "https://search.parallel.ai/mcp",
"oauth": false
}
}
}
重启 OpenCode,并运行 opencode mcp list 检查连接。详情请参阅 OpenCode MCP 指南。
OpenClaw
按照 OpenClaw 设置指南安装 Parallel 插件,然后将 tools.web.search.provider 设置为 parallel-free。无需 Parallel 账号或 API 密钥。
Cursor、VS Code 和其他客户端
使用此远程 MCP 服务 URL:
https://search.parallel.ai/mcp
如果客户端要求选择传输方式,请选择 HTTP 或 Streamable HTTP。请按照客户端专属说明找到正确的设置文件和格式。
试用
向你的 Agent 提问:
使用 Parallel 查找 FastAPI 关于响应模型的官方文档。给我一个简短示例,并附上来源链接。
或者试试:
使用 Parallel 查看最新的 Node.js 稳定版及其发行说明。请引用官方来源。
使用 Parallel 阅读 https://modelcontextprotocol.io/introduction,并解释 MCP 如何将 Agent 连接到工具。
你的 Agent 可以使用两个工具:
| 工具 | 功能 |
|---|---|
web_search | 搜索网络并返回相关摘录及来源链接。 |
web_fetch | 读取指定 URL,并返回页面内容供你的 Agent 使用。 |
搜索结果通常包含足够的信息来回答问题。需要更多详情时,你的 Agent 可以抓取页面。
免费访问和更高限额
此插件在设计上无需身份验证:两个工具都无需账户、API 密钥或登录即可使用,但受免费套餐的速率限制约束。免费套餐适用于个人 Agent、业余项目和探索用途。
如需更高限额、使用分析和生产工作负载支持,请在 platform.parallel.ai 创建账户,并连接 Parallel Search 连接器,该连接器会使用该账户登录。经过身份验证的使用量将根据你账户的定价和限额计费——价格请见 parallel.ai。请勿添加 API 密钥,也不要将此插件指向需要身份验证的端点;连接器会原生处理登录。
两个套餐都包含相同的两个工具。经过身份验证的连接还可让你配置搜索行为,包括搜索模式、结果数量和域名筛选条件。匿名请求会忽略这些设置。
隐私和条款
该服务由 Parallel 托管。搜索查询和请求的 URL 会发送给 Parallel,并根据客户条款和隐私政策进行处理。服务器只会收到工具发送给它的内容——搜索查询和你要求抓取的 URL——不会读取你的对话、文件或其他上下文。
故障排除
- 没有显示工具: 开始新的 Agent 会话,并检查其 MCP 连接列表。确认 URL 为
https://search.parallel.ai/mcp。 - 系统要求登录 Parallel: 检查 URL。
/mcp支持免费访问;/mcp-oauth需要身份验证。在客户端中批准 MCP 连接与登录 Parallel 是两回事。 - 遇到速率限制: 稍后重试,或者通过 Parallel Search 连接器切换到经过身份验证的 Parallel 账户,以获得更高限额。
- 仍然无法解决: 查看设置指南或提交问题。请提供你的客户端、版本和错误消息。请勿提供 API 密钥和其他凭据。
支持和安全
- 问题和 Bug: 提供你的客户端、版本和错误消息(请勿提供 API 密钥和其他凭据)并提交问题,或查看文档。
- 产品支持: 通过 [email protected] 联系 Parallel。
- 安全问题: 请通过 [email protected] 私下报告——请参阅 SECURITY.md。请勿将安全报告作为公开问题提交。
关于此仓库
这是 Parallel 托管式 Search MCP 的官方 GitHub 主页,其中包含本指南以及 Codex、Cursor、Gemini CLI 和 Hermes 的软件包。Codex 和 Cursor 共用 .mcp.json;Hermes 使用可移植的 Agent Plugins v1 plugin.json 和 mcp.json 文件,并会按需加载设置技能(skills/parallel-search-setup/SKILL.md),用于连接检查、使用指导、故障排除和获取更高限额的选项。你可以在此提交文档修正建议和示例。搜索服务运行在 Parallel 的基础设施上;克隆此仓库即可获取文档和配置文件。
如需通过命令行进行搜索、研究和信息补充,请参阅单独的 Parallel CLI skills 插件。
此仓库中的文件采用 MIT 许可证。托管服务的使用受上文链接的客户条款约束。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。