JA

jina-ai/mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

899 stars 95 forks Качество 89 Тренд 37Apache-2.0

Официальный удалённый MCP-сервер Jina AI

Обзор

Удалённый сервер Model Context Protocol (MCP), предоставляющий доступ к Jina Reader, API вэмеддингов и Reranker с набором инструментов URL-to-markdown, веб-поиска, поиска изображений и инструментов встраивания/реранжирования: Опциональные инструменты работают без API-ключа, но имеют ограничения по скорости. Для более высоких ограничений скорости и лучшей производительности используйте ключ Jina API. Вы можете получить бесплатный ключ Jina API через https://jina.ai Некоторые клиенты не поддерживают переменную env, поэтому, возможно, придётся заменить ${JINA_API_KEY} ниже на жёстко закодированный реальный API key jina_xxx. Сервер использует потоковый HTTP-транспорт (спецификация MCP 2025-03-26). Конечная точка /sse сохраняется как псевдоним для обратной совместимости. Подробности см. раздел FAQ. Для клиента, поддерживающего удалённый MCP-сервер: Для клиента, который пока не поддерживает удалённый MCP-сервер, нужен локальный прокси mcp-remote для подключения к удалённому MCP-серверу. Если вы ранее добавили с помощью --transport sse, сначала удалите его с помощью claude mcp, удалите -s user jina, затем добавьте снова с помощью команды ниже.

Обзор (машинный перевод)

Удалённый сервер протокола контекста модели (MCP) для API Jina Reader, Search, Embeddings и Reranker:

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

[! ВНИМАНИЕ] Некоторые клиенты не поддерживают переменную env, поэтому, возможно, придётся заменить ${JINA_API_KEY} ниже на жёстко закодированный реальный API jina_xxx.

Для клиента, поддерживающего удалённый MCP-сервер:

Для Клода Кода:

Для OpenAI Codex: найдите ~/.codex/config.toml и добавьте следующее:

Для клиента, который пока не поддерживает удалённый MCP-сервер, нужен локальный прокси mcp-remote для подключения к удалённому MCP-серверу.

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

Инструмент Описание Требуется ли ключ API Jina?
primer Получите актуальную контекстную информацию для локализованных, временных ответов Нет
read_url Читайте веб-страницу или PDF как markdown. Пропускайте question для отрывков вместо полного текста через Reader API Необязательно*
capture_screenshot_url Сделать скриншот веб-страницы через API Reader Опционально*
guess_datetime_url Угадайте дату публикации или последнего обновления страницы с рейтингом доверия Нет
search_web Поиск в интернете. Возвращает заголовки, URL-адреса и фрагменты движка через API Reader Да

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Jina AI Remote MCP Server

A remote Model Context Protocol (MCP) server for the Jina Reader, Search, Embeddings and Reranker APIs:

Usage

[!WARNING] Some clients do not support env variable, so you may need to replace ${JINA_API_KEY} below to a hardcoded real API key jina_xxx.

For client that supports remote MCP server:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/v1",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}" // optional
      }
    }
  }
}

For Claude Code:

claude mcp add -s user --transport http jina https://mcp.jina.ai/v1 \
  --header "Authorization: Bearer ${JINA_API_KEY}"

For OpenAI Codex: find ~/.codex/config.toml and add the following:

[mcp_servers.jina-mcp-server]
command = "npx"
args = [
    "-y",
    "mcp-remote",
    "https://mcp.jina.ai/v1",
    "--header",
    "Authorization: Bearer ${JINA_API_KEY}"]

For client that does not support remote MCP server yet, you need mcp-remote a local proxy to connect to the remote MCP server.

{
  "mcpServers": {
    "jina-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.jina.ai/v1",
        "--header",
        "Authorization: Bearer ${JINA_API_KEY}"
      ]
    }
  }
}

Available tools

Tool Description Is Jina API Key Required?
primer Get current contextual information for localized, time-aware responses No
read_url Read a web page or PDF as markdown. Pass question for passages instead of the full body via Reader API Optional*
capture_screenshot_url Capture a screenshot of a web page via Reader API Optional*
guess_datetime_url Guess a page’s publish or last-update datetime, with a confidence score No
search_web Search the web. Returns titles, URLs and engine snippets via Reader API Yes
search_arxiv Search academic papers and preprints on arXiv repository via Reader API Yes
search_ssrn Search academic papers on SSRN (Social Science Research Network) via Reader API Yes
search_images Search the web for images via Reader API Yes
search_jina_blog Search Jina AI news and blog posts at jina.ai/news No
sort_by_relevance Rerank documents by relevance to a query via Reranker API Yes
deduplicate_strings Get top-k semantically unique strings via Embeddings API and submodular optimization Yes
Открыть полный README на GitHub

Установка

npx mcp-remote https://mcp.jina.ai/v1 --header Authorization: Bearer ${JINA_API_KEY}
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "jina-mcp-server": { "url": "https://mcp.jina.ai/v1", "headers": { "Authorization": "Bearer ${JINA_API_KEY}" // optional } } } }