Jina AI MCP Multimodal Search

Jina AI MCP服务器

模型上下文协议（MCP）服务器，可与Jina AI的神经搜索功能无缝集成。该服务器通过一个简单的界面实现语义搜索、图像搜索和跨模式搜索功能。

🚀 特性

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

📋 先决条件

• Node.js 16或更高版本
• A Jina AI账户和API密钥(在这里买一个)
• MCP兼容环境（如Cline）

🛠️ 安装

1. 克隆存储库：

git clone 
cd jina-ai-mcp

1. 安装依赖项：

npm install

1. 创建一个 .env 使用您的Jina AI API密钥文件：

JINA_API_KEY=your_api_key_here

1. 构建服务器：

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: "search query text",
    collection: "your-collection-name",
    limit: 10 // optional, defaults to 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 // optional, defaults to 10
  }
})

3.跨模态搜索

执行文本到图像或图像到文本搜索。

use_mcp_tool({
  server_name: "jina-ai",
  tool_name: "cross_modal_search",
  arguments: {
    query: "a beautiful sunset", // or image URL for image2text
    mode: "text2image", // or "image2text"
    collection: "your-collection-name",
    limit: 10 // optional, defaults to 10
  }
})

📝 响应格式

所有搜索工具都以以下格式返回结果：

{
  content: [
    {
      type: "text",
      text: JSON.stringify({
        results: [
          {
            id: string,
            score: number,
            data: Record
          }
        ]
      }, null, 2)
    }
  ]
}

🔐 错误处理

服务器处理各种错误情况：

• API密钥无效
• 参数缺失或无效
• API费率限制
• 网络错误
• 集合名称无效

所有错误的格式都正确，并返回相应的错误代码和消息。

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 名称 AI 因为他们优秀的神经搜索平台
• 模型上下文协议 对于MCP规范