Jina AI MCP Server 使用说明
项目简介
Jina AI MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为大型语言模型 (LLM) 客户端提供强大的外部工具支持。该服务器集成了 Jina AI 的 Web 服务,提供了网页内容提取、网络搜索和事实核查等功能,帮助 LLM 更好地理解和处理网络信息,提升回答的准确性和可靠性。
主要功能点
- 网页内容读取 (read_webpage): 从指定 URL 读取网页内容,并提取为 LLM 友好的格式,支持多种输出格式(Markdown, HTML, Text 等),可选择包含链接、图片和生成图片Alt文本。
- 网络搜索 (search_web): 使用 Jina AI 的搜索 API 进行网络搜索,返回结构化的搜索结果,包括标题、描述和内容,支持多种返回格式(markdown, text, html),并可配置返回结果数量和图片处理方式。
- 事实核查 (fact_check): 使用 Jina AI 的 grounding 引擎对给定的陈述进行事实核查,提供事实性评分、支持证据和参考文献,支持深度分析模式。
安装步骤
本服务器可以通过以下两种方式安装:
方法一: 使用 Smithery (推荐)
如果您使用 Claude Desktop,可以通过 Smithery 快速安装 Jina AI MCP Server。
- 确保已安装 Smithery CLI。
- 运行以下命令安装:
npx -y @smithery/cli install jina-ai-mcp-server --client claude
方法二: 手动安装
-
克隆仓库:
git clone https://github.com/joeBlockchain/mcp-jina-ai.git cd mcp-jina-ai -
安装依赖:
npm install -
构建项目:
npm run build
服务器配置
要将 Jina AI MCP Server 集成到 MCP 客户端(例如 Claude Desktop),您需要配置客户端的 MCP 服务器设置。以下是配置信息,您需要将其添加到客户端的配置文件中。
Claude Desktop 配置 (claude_desktop_config.json):
请根据您的安装方式选择相应的配置,并将以下 JSON 代码块添加到 'claude_desktop_config.json' 文件中的 '"mcpServers"' 字段下。
NPX 方式配置:
{ "jina-ai-mcp-server": { // 服务器名称,客户端内唯一标识 "command": "npx", // 启动命令,这里使用 npx 运行 npm 包 "args": [ // 启动参数 "-y", "jina-ai-mcp-server" // 运行 jina-ai-mcp-server npm 包 ], "env": { // 环境变量 "JINA_API_KEY": "<YOUR_JINA_API_KEY>" // 您的 Jina AI API 密钥,请替换为您的实际密钥,免费获取地址:https://jina.ai/ } } }
本地安装方式配置:
{ "jina-ai-mcp-server": { // 服务器名称,客户端内唯一标识 "command": "node", // 启动命令,这里使用 node 运行 JavaScript 文件 "args": [ // 启动参数 "/path/to/jina-ai-mcp-server/dist/index.js" // 'index.js' 文件的绝对路径,请替换为您的实际路径,例如:/Users/yourname/mcp-jina-ai/dist/index.js ], "env": { // 环境变量 "JINA_API_KEY": "<YOUR_JINA_API_KEY>" // 您的 Jina AI API 密钥,请替换为您的实际密钥,免费获取地址:https://jina.ai/ } } }
配置文件位置:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
获取 Jina AI API Key:
访问 https://jina.ai/ 注册并获取免费的 Jina AI API 密钥,然后将其替换到上述配置中的 '<YOUR_JINA_API_KEY>' 位置。
基本使用方法
配置完成后,启动您的 MCP 客户端(如 Claude Desktop)。客户端将自动连接到 Jina AI MCP Server。
您可以在 LLM 客户端的提示词中,通过特定的语法(通常是 '@工具名(参数)' 的形式,具体取决于客户端实现)来调用 Jina AI MCP Server 提供的工具,例如:
- '@read_webpage(url="https://www.example.com")' 读取 'https://www.example.com' 网页内容。
- '@search_web(query="最新科技新闻")' 搜索 "最新科技新闻"。
- '@fact_check(statement="地球是平的")' 核查 "地球是平的" 这个陈述的真实性。
具体的工具调用方式和参数请参考您的 MCP 客户端的文档。服务器返回的结果将以 JSON 格式呈现,客户端会根据结果进行后续处理。
信息
分类
网页与API