Инструменты Jina AI MCP

Сервер протокола контекста модели (MCP), который интегрируется с API Jina AI Search Foundation.

Возможности

Этот MCP-сервер предоставляет доступ к следующим API Jina AI:

• Web Reader — извлечение контента с веб-страниц с помощью r.jina.ai

• Web Search — поиск в интернете с помощью s.jina.ai или svip.jina.ai (настраивается через --search-endpoint)

Related MCP server: Jina Web Search MCP

Предварительные требования

1. API-ключ Jina AI (необязательно) — получите бесплатный API-ключ на странице https://jina.ai/?sui=apikey для расширенных функций

2. Node.js — версия 16 или выше

MCP-сервер

Использование транспорта stdio (по умолчанию)

Для локальных интеграций, запускаемых другим процессом (например, Claude Desktop, VS Code, Cursor):

{
  "mcpServers": {
    "jina-mcp-tools": {
      "command": "npx",
      "args": [
        "jina-mcp-tools",
        "--transport", "stdio",
        "--tokens-per-page", "15000",
        "--search-endpoint", "standard"
      ],
      "env": {
        "JINA_API_KEY": "your_jina_api_key_here_optional"
      }
    }
  }
}

Использование транспорта HTTP

Для развертывания удаленного сервера, доступного через HTTP:

Запуск сервера:

# With API key
JINA_API_KEY=your_api_key npx jina-mcp-tools --transport http --host 127.0.0.1 --port 3000

# Without API key (reader tool only, binds to 127.0.0.1 by default)
npx jina-mcp-tools --transport http --port 3000

Подключение из MCP-клиентов:

• MCP Inspector: npx @modelcontextprotocol/inspector → http://localhost:3000/mcp

• Claude Code: claude mcp add --transport http jina-tools http://localhost:3000/mcp

• VS Code: code --add-mcp '{"name":"jina-tools","type":"http","url":"http://localhost:3000/mcp"}'

Опции CLI:

• --transport — тип транспорта: stdio или http (по умолчанию: stdio)

• --host — хост/интерфейс для привязки в режиме HTTP (по умолчанию: 127.0.0.1)

• --port — порт HTTP-сервера (по умолчанию: 3000, только для транспорта HTTP)

• --tokens-per-page — количество токенов на страницу для пагинации (по умолчанию: 15000)

• --search-endpoint — используемый эндпоинт поиска: standard (s.jina.ai) или vip (svip.jina.ai) (по умолчанию: standard)

• --cache-size — размер кэша ридера в URL (по умолчанию: 50)

• --help — показать встроенную справку CLI

Переменные окружения прокси

Исходящие HTTP-запросы теперь учитывают стандартные переменные окружения прокси. Это относится к jina_reader, jina_search и jina_search_vip.

• Поддерживаемые переменные прокси: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY

• Также поддерживаются варианты в нижнем регистре: http_proxy, https_proxy, all_proxy

• Исключения учитываются через NO_PROXY / no_proxy

Пример:

HTTPS_PROXY=http://proxy.internal:8080 npx jina-mcp-tools --transport stdio

Доступные инструменты

jina_reader

Извлечение и чтение контента веб-страниц.

Параметры:

• url — URL для чтения (обязательно)

• page — номер страницы для пагинированного контента (по умолчанию: 1)

• customTimeout — переопределение тайм-аута в секундах (необязательно)

Возможности:

• Автоматическая пагинация для больших документов

• LRU-кэш (50 URL) для мгновенных последующих запросов страниц

• URL-адреса файлов GitHub автоматически преобразуются в URL-адреса необработанного контента (raw)

• Сначала пытается использовать Accept: text/markdown для поддерживаемого списка хостов с документацией/блогами, поддерживающими markdown, затем переключается на r.jina.ai в случае сбоя выборки или пустых ответов

jina_search / jina_search_vip

Поиск в интернете. Возвращает частичный контент; используйте jina_reader для получения полного контента. Требуется API-ключ.

Зарегистрированный инструмент зависит от --search-endpoint:

• jina_search → standard (s.jina.ai, по умолчанию)

• jina_search_vip → vip (svip.jina.ai)

Параметры:

• query — поисковый запрос (обязательно)

• count — количество результатов (по умолчанию: 5)

• siteFilter — ограничение по конкретному домену (например, "github.com")

Лицензия

MIT

Ссылки

• GitHub: https://github.com/PsychArch/jina-mcp-tools

• Проблемы: https://github.com/PsychArch/jina-mcp-tools/issues