🚀 Jina AI MCP 服务器
Jina AI MCP 服务器可与 Jina AI 的神经搜索功能实现无缝集成。通过简洁的接口，它能提供语义搜索、图像搜索和跨模态搜索等功能，为用户带来高效的搜索体验。
🚀 快速开始
Jina AI MCP 服务器集成了 Jina AI 的神经搜索功能，提供语义、图像和跨模态搜索。以下是使用前的准备和操作步骤。
✨ 主要特性
- 语义搜索：支持使用自然语言查询，能精准查找语义相似的文档。
- 图像搜索：借助图像 URL 即可搜索视觉上相似的图像。
- 跨模态搜索：可执行文本到图像或图像到文本的搜索，满足多样化的搜索需求。
📦 安装指南
先决条件
- Node.js 16 或更高版本
- Jina AI 账户和 API 密钥（获取此处）
- MCP 兼容环境（例如 Cline）
安装步骤
- 克隆仓库：
git clone
cd jina-ai-mcp
- 安装依赖项：
npm install
- 创建包含 Jina AI API 密钥的
.env文件：
JINA_API_KEY=your_api_key_here
- 构建服务器：
npm run build
⚙️ 配置
在您的 MCP 设置文件中添加以下配置：
{
"mcpServers": {
"jina-ai": {
"command": "node",
"args": [
"/path/to/jina-ai-mcp/build/index.js"
],
"env": {
"JINA_API_KEY": "your_api_key_here"
}
}
}
}
💻 使用示例
基础用法
1. 语义搜索
在文本文档上执行语义/神经搜索。
use_mcp_tool({
server_name: "jina-ai",
tool_name: "semantic_search",
arguments: {
query: "搜索查询文本",
collection: "your-collection-name",
limit: 10 // 可选，默认为 10
}
})
2. 图像搜索
使用图像 URL 搜索相似图像。
use_mcp_tool({
server_name: "jina-ai",
tool_name: "image_search",
arguments: {
imageUrl: "https://example.com/image.jpg",
collection: "your-collection-name",
limit: 10 // 可选，默认为 10
}
})
3. 跨模态搜索
执行文本到图像或图像到文本的搜索。
use_mcp_tool({
server_name: "jina-ai",
tool_name: "cross_modal_search",
arguments: {
query: "美丽的日落", // 或图像 URL 进行图像到文本搜索
mode: "text2image", // 或 "image2text"
collection: "your-collection-name",
limit: 10 // 可选，默认为 10
}
})
📚 详细文档
响应格式
所有搜索工具均以以下格式返回结果：
{
content: [
{
type: "text",
text: JSON.stringify({
results: [
{
id: string,
score: number,
data: Record<string, any>
}
]
}, null, 2)
}
]
}
错误处理
服务器会处理以下各种错误情况：
- 无效的 API 密钥
- 缺少或无效参数
- API 速率限制
- 网络错误
- 无效的集合名称
所有错误均以适当的格式返回，附有相应的错误代码和消息。
🤝 贡献
欢迎贡献！请随时提交拉取请求。
📄 许可证
本项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。
🙏 感谢
- Jina AI：提供了强大的神经搜索功能
- 社区贡献者：感谢您的支持和反馈