使用说明

项目简介

Jina AI MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 应用提供强大的搜索功能。它利用 Jina AI 的神经搜索平台，通过简单的工具调用，即可实现语义搜索、图像搜索和跨模态搜索，从而增强 LLM 应用的上下文理解和信息检索能力。

主要功能点

语义搜索 (Semantic Search): 根据文本查询，查找语义上相似的文档。
图像搜索 (Image Search): 根据图像 URL，查找视觉上相似的图片。
跨模态搜索 (Cross-Modal Search): 支持文本到图像 (text-to-image) 和图像到文本 (image-to-text) 的跨模态搜索。

安装步骤

克隆仓库:

git clone https://github.com/Sheshiyer/jina-ai-mcp-multimodal-search
cd jina-ai-mcp-multimodal-search

安装依赖:
```
npm install
```
创建 '.env' 文件: 在项目根目录下创建 '.env' 文件，并填入你的 Jina AI API 密钥。你需要在 Jina AI Cloud 注册账号并获取 API 密钥。
```
JINA_API_KEY=YOUR_JINA_API_KEY
```
构建服务器:
```
npm run build
```

服务器配置

为了让 MCP 客户端（如 Cline）连接到 Jina AI MCP Server，你需要在客户端的 MCP 设置文件中添加以下服务器配置。这个配置告诉客户端如何启动和连接到 Jina AI MCP Server。

{
  "mcpServers": {
    "jina-ai": {  // 服务器名称，可以自定义，用于在客户端引用
      "command": "node", // 启动服务器的命令，这里使用 Node.js 运行
      "args": [ // 命令参数
        "/path/to/jina-ai-mcp-multimodal-search/build/index.js" //  服务器入口文件路径，请替换为实际路径，例如 /Users/yourname/jina-ai-mcp-multimodal-search/build/index.js
      ],
      "env": { // 环境变量
        "JINA_API_KEY": "YOUR_JINA_API_KEY" // Jina AI API 密钥，与 .env 文件中的密钥保持一致
      }
    }
  }
}

注意:

请将 '/path/to/jina-ai-mcp-multimodal-search' 替换为你克隆仓库后 'jina-ai-mcp-multimodal-search' 文件夹在你的电脑上的绝对路径。
'YOUR_JINA_API_KEY' 需要替换为你实际的 Jina AI API 密钥。

基本使用方法

配置完成后，在 MCP 客户端中，你可以使用以下 'use_mcp_tool' 调用 Jina AI MCP Server 提供的工具。

1. 语义搜索 (semantic_search):

use_mcp_tool({
  server_name: "jina-ai", //  与服务器配置中的 "jina-ai" 名称保持一致
  tool_name: "semantic_search",
  arguments: {
    query: "搜索查询文本",
    collection: "你的 Jina AI Collection 名称" //  替换为你在 Jina AI Cloud 上创建的 Collection 名称
  }
})

2. 图像搜索 (image_search):

use_mcp_tool({
  server_name: "jina-ai",  //  与服务器配置中的 "jina-ai" 名称保持一致
  tool_name: "image_search",
  arguments: {
    imageUrl: "https://example.com/image.jpg", //  替换为你要搜索的图像 URL
    collection: "你的 Jina AI Collection 名称" //  替换为你在 Jina AI Cloud 上创建的 Collection 名称
  }
})

3. 跨模态搜索 (cross_modal_search):

use_mcp_tool({
  server_name: "jina-ai",  //  与服务器配置中的 "jina-ai" 名称保持一致
  tool_name: "cross_modal_search",
  arguments: {
    query: "美丽的日落", //  文本查询 (text2image) 或 图像 URL (image2text)
    mode: "text2image", //  搜索模式，可选 "text2image" 或 "image2text"
    collection: "你的 Jina AI Collection 名称" //  替换为你在 Jina AI Cloud 上创建的 Collection 名称
  }
})

请参考仓库 README.md 文件和代码中的类型定义，了解更多参数和使用细节。

关键词