Jina AI MCP Server

这是一个提供与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: "search query text",
    collection: "your-collection-name",
    limit: 10 // 可选，默认值为1 0
  }
})

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: "a beautiful sunset", // 或用于image2text的图像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 提供了出色的神经搜索平台
• Model Context Protocol 提供了MCP规范