
jina-ai/mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Официальный удалённый 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}ниже на жёстко закодированный реальный APIjina_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 keyjina_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 |
Установка
npx mcp-remote https://mcp.jina.ai/v1 --header Authorization: Bearer ${JINA_API_KEY}Конфигурация
{
"mcpServers": {
"jina-mcp-server": {
"url": "https://mcp.jina.ai/v1",
"headers": {
"Authorization": "Bearer ${JINA_API_KEY}" // optional
}
}
}
}