срезAI — MCP-сервер и поисковый API для ИИ-агентов

srezai-mcp

срезAI 的 MCP 服务——面向 AI Agent 的搜索 API：实时搜索俄语互联网和全球网络，将网页读取为整洁的 Markdown，生成网站地图、按架构提取信息、核验声明、提供现成答案、开展多步骤研究，并将 YouTube 字幕作为 AI Agent 的原生工具。

SrezAI 的 MCP 服务——面向 AI Agent 的搜索 API：实时网页搜索，将网页读取为整洁的 Markdown，生成网站地图、按架构提取信息、核验声明、提供现成答案、开展多步骤研究，并将 YouTube 字幕作为 Agent 原生工具。

您需要这个软件包吗

很可能不需要。 如果您的客户端支持 Streamable HTTP（Claude Desktop、现代 IDE Agent）——可直接连接服务器，无需安装：

{
  "mcpServers": {
    "srezai": {
      "url": "https://srezai.ru/api/mcp",
      "headers": { "Authorization": "Bearer srz_live_ваш_ключ" }
    }
  }
}

如果客户端仅支持 stdio，且不支持通过 HTTP 连接远程服务，则需要这个软件包。

安装

{
  "mcpServers": {
    "srezai": {
      "command": "npx",
      "args": ["-y", "srezai-mcp"],
      "env": { "SREZAI_API_KEY": "srz_live_ваш_ключ" }
    }
  }
}

密钥可在个人账户中创建。需要 Node 18+。

如果 Windows 对环境变量不太配合，某些客户端可以使用以下形式：

cmd /c "set SREZAI_API_KEY=srz_live_ваш_ключ && npx -y srezai-mcp"

工具

工具	功能
web_search	实时网页搜索：标题、链接、摘要。支持类别、语言、新鲜度和域名筛选
image_search	图片：直接链接、来源、分辨率
read_url	网页 → 整洁的 Markdown；内容较长时会按 offset 分窗口返回
read_urls	同上，每次调用最多处理 5 个网页
yt_srt	YouTube 视频字幕（人工或自动）→ Agent 上下文中的文本；支持 from/to 窗口、时间戳，每次调用最多处理 5 个视频。不会下载视频或音频
fetch_page	在浏览器中渲染：截图和 Markdown；如果渲染失败，则只需 1 个点数，而非 3 个
extract	按您的架构提取所请求的字段，不包含网页文本；最多支持 5 个链接
verify_claim	根据 2–5 个独立域名中的逐字引文给出 supported / refuted / mixed / unverified 判定
answer_search	提供带链接的现成答案：搜索、BGE-reranker-v2-m3 语义排序、读取和综合
deep_research	基于多个来源进行 Agent 研究；耗时较长，因此会返回凭证，之后可凭凭证获取答案
get_usage	余额、配额、各项服务的用量和价格表。免费，不消耗配额
map	网站地图：从 sitemap 或首页提取地址和版块，每次调用最多 200 个地址
crawl	地址地图及找到的网页文本；支持按地址和文本筛选

工具说明、参数和价格都由服务器提供，而非存放在软件包中：Agent 在连接时通过 tools/list 获取这些信息。新增工具后，您无需更新 srezai-mcp 就能使用。

只为结果付费：错误和没有返回任何内容的调用不会扣费。1 个点数 = 0.10 ₽，完整价格表可通过 get_usage 获取。

工作原理

这个软件包只是一个轻量桥接程序：从 stdin 读取 JSON-RPC，使用您的密钥转发到 https://srezai.ru/api/mcp，并将响应返回到 stdout。它本身不包含工具逻辑，因此不会与 API 的实际能力不一致。

运行时依赖为零：仅使用 Node 内置模块。

这里不适合使用现成的 mcp-remote：它需要先进行 OAuth 客户端注册，也不支持 срезAI 所使用的静态 Bearer 密钥。

配置 / Configuration

变量	用途
SREZAI_API_KEY	访问密钥。调用工具时需要
SREZAI_MCP_ENDPOINT	其他服务器地址。默认值为 https://srezai.ru/api/mcp

没有密钥时，桥接程序仍会启动并提供 initialize 和 tools/list——工具列表是公开的，MCP 目录通过这种方式读取。此模式下调用任何工具都会返回错误，提示设置 SREZAI_API_KEY。

开发 / Development

npm ci && npm test && npm run build

Docker 镜像（MCP 目录通过在沙盒中查询服务器来构建）：

docker build -t srezai-mcp . && docker run --rm -i -e SREZAI_API_KEY=srz_live_ваш_ключ srezai-mcp

欢迎在 GitHub 上提交修改：CONTRIBUTING.md 说明了为什么 GitVerse 上的副本是镜像，以及在无法访问 GitHub 时如何提交补丁。报告漏洞请参阅 SECURITY.md，不要在公开 issue 中报告。交流规则见 CODE_OF_CONDUCT.md。

许可证 / License

MIT