Jina AI MCP Server 使用说明
项目简介
Jina AI MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在通过 Jina AI 强大的 Web 服务,为大型语言模型 (LLM) 客户端(如 Claude)提供增强功能。它实现了网页内容提取、网络搜索和事实核查三个核心工具,帮助 LLM 更好地理解和处理网络信息。
主要功能点
- 网页内容读取与提取 (read_webpage): 从网页中提取内容,并针对 LLM 的使用场景进行优化,支持多种输出格式(Markdown, HTML, Text 等),并可选择包含链接、图片以及生成图片 Alt Text。
- 网络搜索 (search_web): 利用 Jina AI 的搜索 API 进行网络搜索,返回结构化的搜索结果,包含标题、描述和内容,并支持多种返回格式。
- 事实核查 (fact_check): 使用 Jina AI 的事实核查引擎,对给定的陈述进行事实性验证,提供可信度评分和证据支持,帮助 LLM 判断信息的真实性。
安装步骤
方法一:通过 Smithery 安装 (推荐 Claude Desktop 用户)
如果您使用 Claude Desktop,可以通过 Smithery 快速安装:
npx -y @smithery/cli install jina-ai-mcp-server --client claude
方法二:手动安装
-
克隆仓库:
git clone https://github.com/JoeBuildsStuff/mcp-jina-ai.git cd mcp-jina-ai -
安装依赖:
npm install -
构建项目:
npm run build
服务器配置
MCP 服务器需要配置到 MCP 客户端中才能使用。以 Claude Desktop 为例,您需要在 'claude_desktop_config.json' 文件中添加如下配置信息。
配置信息 (JSON):
{ "mcpServers": { "jina-ai-mcp-server": { "command": "npx", "args": [ "-y", "jina-ai-mcp-server" ], "env": { "JINA_API_KEY": "<YOUR_JINA_AI_API_KEY>" } } } }
参数说明:
- '"jina-ai-mcp-server"': 服务器名称,在客户端中用于标识和引用。
- '"command": "npx"': 启动服务器的命令,这里使用 'npx' 直接运行 'jina-ai-mcp-server' 包。
- '"args": ["-y", "jina-ai-mcp-server"]': 'npx' 命令的参数,'-y' 表示自动确认安装,'jina-ai-mcp-server' 是要执行的包名。
- '"env": { "JINA_API_KEY": "<YOUR_JINA_AI_API_KEY>" }': 设置环境变量,'JINA_API_KEY' 用于 Jina AI 服务的身份验证。请务必替换 '<YOUR_JINA_AI_API_KEY>' 为您在 Jina AI 官网 申请的 API 密钥。
'claude_desktop_config.json' 文件位置:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
如果您选择本地安装,请使用以下配置:
{ "mcpServers": { "jina-ai-mcp-server": { "command": "node", "args": [ "/path/to/jina-ai-mcp-server/dist/index.js" ], "env": { "JINA_API_KEY": "<YOUR_JINA_AI_API_KEY>" } } } }
参数说明 (本地安装):
- '"command": "node"': 使用 Node.js 运行服务器。
- '"args": ["/path/to/jina-ai-mcp-server/dist/index.js"]': 'node' 命令的参数,指向您本地安装的 'jina-ai-mcp-server' 项目 'dist' 目录下编译后的 'index.js' 文件。请将 '"/path/to/jina-ai-mcp-server"' 替换为您的实际项目路径。
- '"env": { "JINA_API_KEY": "<YOUR_JINA_AI_API_KEY>" }': 环境变量设置,与 'npx' 安装方式相同。
基本使用方法
配置完成后,当您在 Claude 等 MCP 客户端中使用需要网页读取、网络搜索或事实核查功能时,客户端会通过 MCP 协议与 Jina AI MCP Server 通信,调用相应的工具获取结果,并返回给您。您无需直接与服务器交互,只需在客户端的正常使用流程中触发相关功能即可。
例如,在 Claude 中,您可以提问类似 "请总结一下 [网页链接]" 或 "搜索关于 [主题] 的信息" 的问题,Claude 就会自动调用 Jina AI MCP Server 提供的工具来完成任务。
信息
分类
网页与API