mcp-jinaai-search

⚠️ 通知

此仓库不再维护。

该工具的功能现在可以在 mcp-omnisearch 中找到，它将多个 MCP 工具整合在一个统一的包中。

请改用 mcp-omnisearch。

一个用于将 Jina.ai 的搜索 API 与 LLM 集成的 Model Context Protocol (MCP) 服务器。此服务器提供了高效的全面网络搜索功能，优化了从网络检索干净且适合 LLM 的内容。

特性

• 🔍 通过 Jina.ai 搜索 API 进行高级网络搜索
• 🚀 快速高效的内容检索
• 📄 保持结构的干净文本提取
• 🧠 为 LLM 优化的内容
• 🌐 支持各种内容类型，包括文档
• 🏗️ 基于 Model Context Protocol 构建
• 🔄 可配置的缓存以提高性能
• 🖼️ 可选的图片和链接收集
• 🌍 通过浏览器语言环境支持本地化
• 🎯 用于控制响应大小的令牌预算控制

配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例：

Cline 配置

将以下内容添加到您的 Cline MCP 设置中：

{
    "mcpServers": {
        "jinaai-search": {
            "command": "node",
            "args": ["-y", "mcp-jinaai-search"],
            "env": {
                "JINAAI_API_KEY": "your-jinaai-api-key"
            }
        }
    }
}

Claude Desktop 使用 WSL 配置

对于 WSL 环境，请将以下内容添加到您的 Claude Desktop 配置中：

{
    "mcpServers": {
        "jinaai-search": {
            "command": "wsl.exe",
            "args": [
                "bash",
                "-c",
                "JINAAI_API_KEY=your-jinaai-api-key npx mcp-jinaai-search"
            ]
        }
    }
}

环境变量

服务器需要以下环境变量：

• JINAAI_API_KEY: 您的 Jina.ai API 密钥（必需）

API

服务器实现了一个具有可配置参数的单个 MCP 工具：

search

使用 Jina.ai Reader 搜索网络并获取干净、适合 LLM 的内容。返回带有 URL 和干净内容的前 5 条结果。

参数：

• query (字符串, 必需): 搜索查询
• format (字符串, 可选): 响应格式 ("json" 或 "text")。默认为 "text"
• no_cache (布尔值, 可选): 绕过缓存以获取最新结果。默认为 false
• token_budget (数字, 可选): 此请求的最大令牌数
• browser_locale (字符串, 可选): 用于渲染内容的浏览器语言环境
• stream (布尔值, 可选): 对大型页面启用流模式。默认为 false
• gather_links (布尔值, 可选): 在响应末尾收集所有链接。默认为 false
• gather_images (布尔值, 可选): 在响应末尾收集所有图片。默认为 false
• image_caption (布尔值, 可选): 为内容中的图片添加标题。默认为 false
• enable_iframe (布尔值, 可选): 从 iframe 提取内容。默认为 false
• enable_shadow_dom (布尔值, 可选): 从 shadow DOM 提取内容。默认为 false
• resolve_redirects (布尔值, 可选): 跟随重定向链到最终 URL。默认为 true

开发

设置

1. 克隆仓库
2. 安装依赖项：

pnpm install

1. 构建项目：

pnpm run build

1. 以开发模式运行：

pnpm run dev

发布

1. 创建更改集：

pnpm changeset

1. 版本化包：

pnpm version

1. 构建并发布：

pnpm release

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证 - 详情见 LICENSE 文件。

致谢

• 基于 Model Context Protocol 构建
• 由 Jina.ai Search API 驱动