mcp-jinaai-search

---

⚠️ 注意

此仓库已停止维护。

此工具的功能现在已包含在 mcp-omnisearch 中，它将多个 MCP 工具整合到一个统一的包中。

请使用 mcp-omnisearch 代替。

---

一个模型上下文协议 (MCP) 服务器，用于集成 Jina.ai 的搜索 API 与 LLM。此服务器提供高效且全面的网络搜索功能，经过优化，可从网络检索干净、LLM 友好的内容。

<a href="https://glama.ai/mcp/servers/u6603w196t"> <img width="380" height="200" src="https://glama.ai/mcp/servers/u6603w196t/badge" /> </a>

特性

• 🔍 通过 Jina.ai 搜索 API 进行高级网络搜索
• 🚀 快速高效的内容检索
• 📄 提取具有保留结构的干净文本
• 🧠 针对 LLM 优化的内容
• 🌐 支持各种内容类型，包括文档
• 🏗️ 构建在模型上下文协议之上
• 🔄 可配置的缓存以提高性能
• 🖼️ 可选的图像和链接收集
• 🌍 通过浏览器区域设置支持本地化
• 🎯 响应大小的 Token 预算控制

配置

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

Cline 配置

将其添加到您的 Cline MCP 设置中：

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

带有 WSL 配置的 Claude Desktop

对于 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 友好的内容。返回前 5 个结果，包含 URL 和干净的内容。

参数：

• query (string, required): 搜索查询
• format (string, optional): 响应格式 ("json" 或 "text")。默认为 "text"
• no_cache (boolean, optional): 绕过缓存以获取最新结果。默认为 false
• token_budget (number, optional): 此请求的最大 Token 数
• browser_locale (string, optional): 用于渲染内容的浏览器区域设置
• stream (boolean, optional): 为大型页面启用流模式。默认为 false
• gather_links (boolean, optional): 在响应末尾收集所有链接。默认为 false
• gather_images (boolean, optional): 在响应末尾收集所有图像。默认为 false
• image_caption (boolean, optional): 在内容中为图像添加标题。默认为 false
• enable_iframe (boolean, optional): 从 iframe 中提取内容。默认为 false
• enable_shadow_dom (boolean, optional): 从 shadow DOM 中提取内容。默认为 false
• resolve_redirects (boolean, optional): 跟踪重定向链到最终 URL。默认为 true

开发

设置

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

pnpm install

3. 构建项目：

pnpm run build

4. 在开发模式下运行：

pnpm run dev

发布

1. 创建一个 changeset：

pnpm changeset

2. 版本化包：

pnpm version

3. 构建和发布：

pnpm release

贡献

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

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件。

致谢

• 构建在 模型上下文协议 之上
• 由 Jina.ai 搜索 API 提供支持