跳转到主要内容
StepSearch MCP Server 是基于模型上下文协议(Model Context Protocol)实现的搜索服务,为 Claude Code、Cline、OpenCode 等兼容 MCP 的客户端提供阶跃星辰的专业搜索能力,包括网络搜索、网页内容获取等功能。

功能特性

  • 实时搜索:支持全网搜索,获取最新的网络信息和资源
  • 编程增强:在开发过程中检索编程最佳实践、API 文档及论文等
  • 远程服务:基于 HTTP 协议的远程 MCP 服务,无需本地安装

支持的工具

该服务实现了模型上下文协议,可与任何兼容 MCP 的客户端一起使用。目前提供以下工具:
工具说明
web_search全网信息检索与索引化结果输出
web_fetch指定 URL 的网页内容抓取与结构化提取

快速开始

1. 获取访问令牌

前往 阶跃星辰开放平台 获取您的 API Key。

2. 配置 MCP 服务器

根据您使用的客户端,选择对应标签页查看配置方式。
一键安装命令:
手动配置:编辑 Claude Code 的配置文件(位于用户目录下 ~/.claude.json):

使用示例与最佳实践

将搜索 MCP 服务器安装到客户端后,即可在对话中直接使用搜索能力。以下是几种典型使用场景。

预备:创建搜索专用 Agent

Claude Code 通过 .claude/agents/ 目录下的定义文件来识别可用的 Sub-Agent。创建专用搜索 Agent 后,Claude Code 可以在需要实时信息时自动调用该 Sub-Agent 执行搜索任务,每次处理一个查询并返回结构化结果。 1. 创建 Agent 定义文件 在项目根目录下创建 .claude/agents/search-agent.md
2. 在 CLAUDE.md 中配置调用规则 在项目的 CLAUDE.md 中添加以下内容,告诉 Claude Code 什么时候使用搜索 Agent:

场景一:多 API 文档查询

项目集成多个第三方服务时,需要获取各服务的最新 API 用法。第三方 API 随时可能更新,模型训练时的文档版本可能已过时。

场景二:代码安全审计 + CVE 搜索

审查代码安全性时,模型可以识别漏洞模式,但需要搜索最新的 CVE 信息和安全公告。

场景三:依赖升级影响分析

升级主要依赖版本时,新版本的 breaking changes 和社区反馈往往是模型训练后产生的实时信息。

场景四:开源生态实时调研

评估开源项目时,GitHub stars、最近 commit、维护者动态都是实时数据,模型无法直接回答。

MCP 使用额度说明

  • 计费规则web_search 按照开放平台网络搜索的计价方式收费,每次调用 0.04 元,与 Step Plan 其他用量一并消耗 Credit 额度;web_fetch 不单独计费
  • 额度周期:消耗 Step Plan 月度 Credit,月池月末清零,可用加油包补充
  • 限流策略:以 QPM / QPH / 并发控制为主,并对单用户增加必要限频
如需订阅或升级套餐,请访问:Step Plan 订阅

常见问题

访问令牌无效?

  • 确认 API Key 已完整复制,没有多余空格
  • 验证 Key 已激活且余额充足
  • 检查 Authorization 头格式是否正确(需包含 Bearer 前缀,注意空格)

连接超时?

  • 检查网络连接是否正常
  • 确认防火墙未拦截对 api.stepfun.com 的访问
  • 确认服务端点 URL 拼写正确

搜索结果为空?

  • 尝试调整搜索关键词的表述方式
  • 避免过于具体或过于宽泛的查询条件
  • 确保网络连接正常

参考链接