npm-пакет tube-search-mcp
Пакет tube-search-mcp — лёгкий stdio-to-HTTP прокси, который подключает ваш локальный AI-клиент к MCP-серверу Tube Search. Никакой настройки сервера не нужно.
Как это работает
AI-клиент ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcpПакет читает MCP-сообщения из stdin, перенаправляет их на удалённый сервер Tube Search через Streamable HTTP и пишет ответы в stdout. Ваш AI-клиент думает, что общается с локальным MCP-сервером.
Установка
Установка не нужна — запускайте напрямую через npx:
npx tube-search-mcp --api-key tsk_ВАШ_КЛЮЧИли установите глобально:
npm install -g tube-search-mcpНастройка
Полные примеры конфигурации для каждого клиента — в руководстве быстрого старта.
Параметры CLI
| Параметр | Описание | По умолч. |
|---|---|---|
--api-key <key> | API-ключ (tsk_...) | перем. TUBE_API_KEY |
--url <url> | Кастомный MCP-эндпоинт | https://tube.archivarix.net/mcp |
--help | Показать справку | — |
--version | Показать версию | — |
Переменные окружения
| Переменная | Описание |
|---|---|
TUBE_API_KEY | API-ключ (обязателен, если не указан --api-key) |
TUBE_MCP_URL | Переопределить URL MCP-эндпоинта |
Когда использовать npm-пакет, а когда Remote URL
Claude Desktop и Claude Code поддерживают оба метода:
- npm-пакет (stdio) — работает со всеми MCP-клиентами, нет проблем с файрволом
- Remote URL — не нужен npm/Node.js, чуть меньше задержка, поддерживается только Claude Desktop и Claude Code
Для Cursor и VS Code npm-пакет — единственный вариант.
Устранение неполадок
Ошибка: "TUBE_API_KEY environment variable is required"
Убедитесь, что вы установили TUBE_API_KEY в конфигурации окружения клиента или передали ключ через --api-key.
Таймаут соединения
Проверьте подключение к интернету. Пакету нужен доступ к tube.archivarix.net.
Ошибка авторизации
Проверьте, что ваш API-ключ действителен в Профиль → API. Если вы его перегенерировали, обновите ключ в конфигурации клиента.
Первый запуск медленный
Первый запуск через npx скачивает пакет. Последующие запуски используют кешированную версию.