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

srezai-mcp

срезAI の MCP サーバーは、AI エージェント向けの検索 API です。Runet とグローバルウェブをリアルタイムで検索し、ページをクリーンな Markdown として読み込み、サイトマップを取得し、スキーマに基づいて抽出し、主張を検証し、回答を生成します。多段階の調査や YouTube の字幕も、AI エージェントの組み込みツールとして利用できます。

срезAI 向けの MCP サーバーです。AI エージェント向けの検索 API として、ウェブのリアルタイム検索、ページのクリーンな Markdown への読み込み、サイトマップ、スキーマに基づく抽出、主張の検証、回答の生成、多段階の調査、YouTube の文字起こしを、エージェントのネイティブツールとして提供します。

このパッケージは必要ですか / Do you need this package

おそらく必要ありません。 クライアントが Streamable HTTP（Claude Desktop、最新の IDE エージェントなど）に対応している場合は、インストールせずにサーバーへ直接接続してください。

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

このパッケージが必要なのは、クライアントが stdio のみに対応し、HTTP 経由のリモートサーバーをサポートしていない場合です。

インストール / Installation

{
  "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"

ツール / Tools

ツール	機能
web_search	ウェブのリアルタイム検索：タイトル、リンク、抜粋。カテゴリ、言語、鮮度、ドメインによるフィルター
image_search	画像：直接リンク、ソース、解像度
read_url	ページ → クリーンな Markdown。長いページは offset で分割して返します
read_urls	同様の処理を、1 回の呼び出しで最大 5 ページに対して実行します
yt_srt	YouTube 動画の字幕（手動または自動）をエージェントのコンテキスト用テキストに変換します。from／to による範囲指定、タイムスタンプに対応し、1 回の呼び出しで最大 5 本の動画を処理します。動画や音声はダウンロードしません
fetch_page	ブラウザーでレンダリング：スクリーンショットと Markdown。レンダリングに失敗した場合は、3 クレジットではなく 1 クレジットでテキストを返します
extract	ページのテキストは含めず、指定したスキーマに基づいて要求されたフィールドのみを抽出します。最大 5 件のリンクに対応
verify_claim	2～5 件の独立したドメインからの逐語引用を添えて、supported／refuted／mixed／unverified の判定を返します
answer_search	リンク付きの回答を生成します。検索、BGE-reranker-v2-m3 による意味的なランキング、読み込み、統合を行います
deep_research	多数のソースを用いたエージェントによる調査です。時間がかかるため、引換券を返し、その券を使って回答を取得します
get_usage	残高、クォータ、サービスごとの利用状況、料金表を確認できます。無料で、クォータを消費しません
map	サイトマップ：sitemap またはトップページから URL とセクションを取得します。1 回の呼び出しで最大 200 URL
crawl	URL のマップと、見つかったページのテキストを取得します。URL とテキストでフィルターできます

説明、パラメーター、料金はパッケージではなくサーバー上で管理されています。エージェントは接続時に tools/list を通じてこれらを取得します。新しいツールも srezai-mcp を更新せずに利用できます。

結果が得られた場合にのみ料金が発生します。エラーや、何も得られなかった呼び出しではクレジットは消費されません。1 クレジット = 0.10 ₽ です。正確な料金表は get_usage で取得できます。

仕組み / How it works

このパッケージはシンプルなブリッジです。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 を利用できない場合のパッチの送信方法を説明しています。脆弱性については、公開 issue ではなく SECURITY.md をご覧ください。行動規範については CODE_OF_CONDUCT.md をご覧ください。

ライセンス / License

MIT