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
