网页内容提取与搜索服务

Jina AI MCP Server是一个通过Claude提供网页内容提取、网页搜索和事实核查功能的服务器。

  • by JoeBuildsStuff
  • JavaScript
  • 本地部署
  • 28 星标
  • 更新于
在 GitHub 查看 JoeBuildsStuff/mcp-jina-ai

使用说明

Jina AI MCP服务器

一个MCP服务器,通过Claude提供对Jina AI强大网络服务的访问。此服务器实现了三个主要工具:

  • 网页阅读和内容提取
  • 网络搜索
  • 事实核查/接地

特性

工具

read_webpage

  • 以针对LLM优化的格式从网页中提取内容
  • 支持多种输出格式(默认、Markdown、HTML、文本、截图、页面截图)
  • 包含链接和图像的选项
  • 能够为图像生成alt文本
  • 缓存控制选项

search_web

  • 使用Jina AI的搜索API搜索网页
  • 可配置的结果数量(默认值:5)
  • 支持图像保留和alt文本生成
  • 多种返回格式(markdown、text、html)
  • 返回带有标题、描述和内容的结构化结果

fact_check

  • 使用Jina AI的接地引擎进行事实核查
  • 提供事实性评分和支持性证据
  • 可选深潜模式,可进行更彻底的分析
  • 返回带有关键引号和支持/矛盾分类的引用

设置

先决条件

您需要一个Jina AI API密钥才能使用此服务器。免费获得一个https://jina.ai/

安装

有两种方法可以使用此服务器:

通过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:本地安装

  1. 克隆存储库
  2. 安装依赖项:
npm install
  1. 构建服务器:
npm run build
  1. 将此配置添加到您的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服务器通过stdio进行通信,调试可能具有挑战性。我们建议使用 MCP检查员:

npm run inspector

检查器将提供一个URL,用于访问浏览器中的调试工具。

API响应类型

所有工具都返回结构化的JSON响应,其中包括:

  • 状态代码和元数据
  • 根据请求的输出类型格式化内容
  • 使用信息(令牌计数)
  • 适用时:图像、链接和其他元数据

有关详细的架构信息,请参见 schemas.ts.

运行评估

evals包加载一个mcp客户端,然后运行index.ts文件,因此不需要在测试之间重建。您可以通过在npx命令前加前缀来加载环境变量。可以找到完整的文档 这里.

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts index.ts