AI导哈

远程模型上下文协议服务器

Jina AI提供的远程模型上下文协议服务器，支持访问Jina Reader、Embeddings和Reranker API，提供URL转Markdown、网页搜索、图像搜索以及嵌入/重排工具。

  • by acchuang
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 acchuang/jina-mcp-server

使用说明

Jina AI远程MCP服务器

远程模型上下文协议（MCP）服务器，提供对Jina Reader、Embeddeds和Reranker API的访问，并提供一套用于标记、网络搜索、图像搜索和嵌入/重新链接工具的URL：

工具 说明 是否需要Jina API密钥？
primer 获取本地化、时间感知响应的当前上下文信息 否
read_url 通过markdown从网页中提取干净、结构化的内容 读者API 可选*
capture_screenshot_url 通过以下方式捕获网页的高质量屏幕截图 读者API 可选*
guess_datetime_url 使用置信度分数分析网页的上次更新/发布日期时间 否
search_web 通过以下方式在整个网络上搜索当前信息和新闻 读者API 是的
search_arxiv 通过arXiv存储库搜索学术论文和预印本 读者API 是的
search_images 通过以下方式在网络上搜索图像（类似于谷歌图像） 读者API 是的
expand_query 基于查询扩展模型，通过以下方式扩展和重写搜索查询 读者API 是的
parallel_read_url 通过以下方式并行读取多个网页，以实现高效的内容提取 读者API 可选*
parallel_search_web 通过以下方式并行运行多个网络搜索，以获得全面的主题报道和不同的观点 读者API 是的
parallel_search_arxiv 通过以下方式并行运行多个arXiv搜索，以获得全面的研究覆盖范围和不同的学术角度 读者API 是的
sort_by_relevance 通过以下方式按与查询的相关性重新排列文档 重新排名 API 是的
deduplicate_strings 通过以下方式获取top-k语义唯一的字符串 嵌入API 和 子模型优化 是的
deduplicate_images 通过以下方式获取top-k语义唯一的图像 嵌入API 和 子模型优化 是的

可选工具在没有API密钥的情况下工作，但具有 费率限制.为了获得更高的速率限制和更好的性能，请使用Jina API密钥。您可以从获得免费的Jina API密钥 https://jina.ai

用法

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

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

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

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

故障排除

我陷入了一个工具调用循环——发生了什么事？

当默认上下文窗口为4096，并且您使用的思维模型如 gpt-oss-120b 或 qwen3-4b-thinking随着思维和工具调用的继续，一旦达到上下文窗口限制，人工智能就会开始失去对任务开始的跟踪。这就是它被困在这个滚动上下文窗口中的原因。

解决方案是加载具有足够上下文长度的模型，以包含完整的工具调用链和思维过程。

我看不到所有的工具。

一些MCP客户端具有本地缓存，并且不会主动更新工具定义。如果您没有看到所有可用的工具，或者工具似乎已经过时，您可能需要将jina-mcp服务器删除并重新添加到mcp客户端配置中。这将强制客户端刷新其缓存的工具定义。在LMStudio中，您可以单击刷新按钮加载新工具。

Claude Desktop在Windows上显示“服务器已断开连接”

光标和克劳德桌面（Windows） 有个bug 当它调用npx时，args中的空格不会转义，这最终会破坏这些值。您可以使用以下方法解决此问题：

{
  // rest of config...
  "args": [
    "mcp-remote",
    "https://mcp.jina.ai/sse",
    "--header",
    "Authorization:${AUTH_HEADER}" // note no spaces around ':'
  ],
  "env": {
    "AUTH_HEADER": "Bearer <JINA_API_KEY>" // spaces OK in env vars
  }
},

光标在此MCP状态上显示一个红点

可能是Cursor的UI错误，但MCP工作正常，没有任何问题。如果您觉得红点很烦人，可以关闭/打开以“重新启动”MCP（事实上，由于您将其用作远程MCP，因此这不是真正的“服务器重新启动”，而主要是本地代理重新启动）。

我的法学硕士从不使用某些工具

假设您的MCP客户端中启用了所有工具，但您的LLM仍然从未使用过某些工具，那么您的LLM可能更喜欢某些工具而不是其他工具，这在LLM使用一组特定工具进行培训时非常常见。例如，我们很少看到 parallel_* LLM正在有机地使用工具，除非明确指示这样做。在Cursor中，您可以将以下规则添加到您的 .mdc 文件：

---
alwaysApply: true
---

When you are uncertain about knowledge, or the user doubts your answer, always use Jina MCP tools to search and read best practices and latest information. Use search_arxiv and read_url together when questions relate to theoretical deep learning or algorithm details. search_web and search_arxiv cannot be used alone - always combine with read_url or parallel_read_url to read from multiple sources. Remember: every search must be complemented with read_url to read the source URL content. For maximum efficiency, use parallel_* versions of search and read when necessary.

开发者指南

地方发展

# Clone the repository
git clone https://github.com/jina-ai/MCP.git
cd MCP

# Install dependencies
npm install

# Start development server
npm run start

部署到Cloudflare Workers

这将把您的MCP服务器部署到以下URL： jina-mcp-server.<your-account>.workers.dev/sse

相关 MCP