jina-ai/mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

896 stars 95 forks 质量 89 趋势 37Apache-2.0

Repository Install

官方 Jina AI 远程 MCP 服务器

概览

一个远程模型上下文协议（MCP）服务器，提供对 Jina Reader、嵌入和重新排序 API 的访问，并配备一系列 URL-标记、网页搜索、图片搜索及嵌入/重置工具：可选工具无需API密钥，但有速率限制。想要更高的速率限制和更好的性能，可以使用Jina API密钥。你可以从[[T0]获得免费的Jina API密钥。有些客户端不支持 env 变量，所以你可能需要把下面的 ${JINA_API_KEY} 替换成硬编码的真实 API 密钥jina_xxx。服务器使用可流式HTTP传输（MCP规范2025-03-26）。/sse端点作为别名保留以实现向后兼容。详情请参见常见问题解答。对于支持远程MCP服务器的客户端：对于尚未支持远程MCP服务器的客户端，你需要mcp-remote本地代理连接到远程MCP服务器。如果你之前添加了 --transport sse，先用 claude mcp remove -s 用户 jina 删除它，然后用下面的命令重新添加。

概述（AI 翻译）

用于 Jina Reader、Search、Embedding 和 Reranker API 的远程模型上下文协议（MCP）服务器：

用途

[!警告] 有些客户端不支持env变量，所以你可能需要将下面的${JINA_API_KEY}替换为硬编码的真实API密钥jina_xxx。

对于支持远程MCP服务器的客户端：

对于Claude代码：

关于OpenAI手本：查找~/.codex/config.toml并添加以下内容：

对于尚未支持远程MCP服务器的客户端，你需要mcp-remote本地代理连接到远程MCP服务器。

可用工具

工具	描述	是否需要 Jina API 密钥？
`primer`	获取本地化、时间感知响应的当前上下文信息	否
`read_url`	阅读网页或PDF作为标记。通过阅读器API通过全文，跳过`question`代替全文	可选*
`capture_screenshot_url`	通过阅读器API截取网页截图	可选*
`guess_datetime_url`	猜测页面的发布或最后更新日期时间，并带有信心评分	否
`search_web`	在网上搜索。通过Reader API返回标题、URL和引擎摘要	是的

本页由 AI 翻译，技术细节请以原文为准。

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

在 GitHub 查看完整 README

安装

npx mcp-remote https://mcp.jina.ai/v1 --header Authorization: Bearer ${JINA_API_KEY}

新手？先看 mcpskill.org 教程 →

配置

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