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 以跟踪请求。
- 结果数据会根据具体功能而有所不同。
请确保您正确解析这些响应,以便在应用中使用。
微信扫一扫