JinDaGe - mcp-jina-ai MCP Details

article

README

🚀 Jina AI MCP 服务器

一个 MCP 服务器，借助 Claude 提供对 Jina AI 强大网络服务的访问。此服务器实现了三大主要工具，分别为网页阅读与内容提取、网页搜索以及事实核查/定位。

✨ 主要特性

工具

`read_webpage`

从网页提取内容，格式适配 LLM 使用。
支持多种输出格式，如默认、Markdown、HTML、文本、截图、Pageshot。
可选择是否包含链接和图片。
具备自动生成图片描述文字的功能。
提供缓存控制选项。

`search_web`

运用 Jina AI 的搜索 API 开展网页搜索。
搜索结果数量可配置，默认显示 5 个。
支持保留图片并生成描述文字。
支持多种返回格式，如 Markdown、文本、HTML。
结果为结构化形式，包含标题、描述和内容。

`fact_check`

利用 Jina AI 的定位引擎进行事实核查。
提供真实度评分以及支持证据。
可选择深度模式以获取更全面的分析。
返回引用信息，涵盖关键摘录及其支持/矛盾分类。

📦 安装指南

前提条件

使用此服务器需要一个 Jina AI API 密钥，您可免费从 https://jina.ai/ 获取。

安装方法

有以下两种方式可供使用该服务器：

使用 Smithery 安装（推荐）

通过 Smithery 自动安装 Jina AI for Claude Desktop：

npx -y @smithery/cli install jina-ai-mcp-server --client claude

选项 1：使用 NPX（推荐）

将以下配置添加到您的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "jina-ai-mcp-server"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

选项 2：本地安装

克隆仓库。
安装依赖：

npm install

构建服务器：

npm run build

将以下配置添加到您的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/jina-ai-mcp-server/dist/index.js"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

配置文件位置

在 MacOS 上：

~/Library/Application Support/Claude/claude_desktop_config.json

在 Windows 上：

%APPDATA%/Claude/claude_desktop_config.json

调试

由于 MCP 服务器通过标准输入输出进行通信，调试可能存在挑战。我们推荐使用 MCP Inspector：

npm run inspector

Inspector 将提供一个可访问浏览器调试工具的 URL。

📚 详细文档

API 响应类型

所有工具都返回结构化的 JSON 响应，包含以下内容：

状态码和相关信息。
请求 ID 以跟踪请求。
结果数据会根据具体功能而有所不同。

请确保您正确解析这些响应，以便在应用中使用。

mcp-jina-ai