Jina AI MCP 服务器

一个与 Jina AI 的神经搜索功能无缝集成的模型上下文协议 (MCP) 服务器。此服务器通过简单的接口提供语义搜索、图像搜索和跨模态搜索功能。

🚀 功能

• 语义搜索：使用自然语言查询查找语义相似的文档
• 图像搜索：使用图像 URL 搜索视觉上相似的图像
• 跨模态搜索：执行文本到图像或图像到文本的搜索

📋 先决条件

• Node.js 16 或更高版本
• Jina AI 账户和 API 密钥（获取此处）
• MCP 兼容环境（例如 Cline）

🛠️ 安装

1. 克隆仓库：

git clone <repository-url>
cd jina-ai-mcp

2. 安装依赖项：

npm install

3. 创建包含 Jina AI API 密钥的 .env 文件：

JINA_API_KEY=your_api_key_here

4. 构建服务器：

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：提供了强大的神经搜索功能
• 社区贡献者：感谢您的支持和反馈