Srezai

srezai-mcp

MCP-сервер срезAI — поисковый API для ИИ-агентов: живой веб-поиск по Рунету и глобальному вебу, чтение страниц в чистый Markdown, карта сайта, извлечение по схеме, проверка утверждений, готовые ответы, многошаговое исследование и субтитры YouTube как встроенные инструменты ИИ-агента.

MCP server for SrezAI — a search API for AI agents: live web search, page reading into clean Markdown, site map, schema-based extraction, claim verification, ready answers, multi-step research and YouTube transcripts as native agent tools.

Нужен ли вам этот пакет / 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

Описания, параметры и цены живут на сервере, а не в пакете: агент видит их через tools/list в момент подключения. Новый инструмент появляется у вас без обновления srezai-mcp.

Платите только за результат: ошибка и вызов, не принёсший ничего, не списываются. 1 кредит = 0,10 ₽, точный прайс-лист отдаёт get_usage.

Как это работает / How it works

Пакет — тонкий мост: читает JSON-RPC из stdin, пересылает на https://srezai.ru/api/mcp с вашим ключом, возвращает ответ в stdout. Собственной логики инструментов в нём нет — поэтому он не может разойтись с тем, что на самом деле умеет API.

Зависимостей во время работы — ноль: только встроенные модули Node.

Готовый mcp-remote здесь не подошёл: он начинает с OAuth-регистрации клиента и не умеет статический Bearer-ключ, на котором работает срезAI.

Настройка / Configuration

Без ключа мост всё равно запускается и отдаёт initialize и tools/list: список инструментов сервер публикует анонимно, так его читают каталоги MCP. Вызов любого инструмента в этом режиме вернёт ошибку с указанием задать SREZAI_API_KEY. / Without a key the bridge still starts and serves initialize and tools/list — the tool list is public, which is how MCP directories read it. Calling a tool returns an error asking you to set SREZAI_API_KEY.

Claude Code: плагин из маркетплейса / Claude Code plugin

Репозиторий сам является маркетплейсом Claude Code: плагин srezai-web-access подключает удалённый MCP-сервер srezai.ru одной командой.

/plugin marketplace add srezai-team/srezai-mcp-web-search
/plugin install srezai-web-access@srezai-mcp

После установки сервер srezai работает как обычный MCP с 14 инструментами. Без ключа действует бесплатный режим — 25 запросов в сутки с одного IP. Для платных инструментов ключ добавляется вручную:

claude mcp add --transport http srezai https://srezai.ru/api/mcp \
  --header "Authorization: Bearer srz_live_ваш_ключ"

Файлы маркетплейса: .claude-plugin/marketplace.json и plugins/srezai-web-access/ (.claude-plugin/plugin.json + .mcp.json). Валидация: claude plugin validate . → «Validation passed».

Разработка / Development

npm ci && npm test && npm run build

Docker-образ (его собирают каталоги MCP, опрашивая сервер в песочнице) / Docker image, built by MCP directories to introspect the server in a sandbox:

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.

Changes go to GitHub: CONTRIBUTING.md explains why the GitVerse copy is a mirror and how to send a patch if GitHub is unavailable to you. For vulnerabilities see SECURITY.md rather than a public issue. Ground rules: CODE_OF_CONDUCT.md.

Лицензия / License

MIT