Jina Ai MCP Multimodal Search

🚀 Jina AI MCP 服務器

Jina AI MCP 服務器可與 Jina AI 的神經搜索功能實現無縫集成。通過簡潔的接口，它能提供語義搜索、圖像搜索和跨模態搜索等功能，為用戶帶來高效的搜索體驗。

🚀 快速開始

Jina AI MCP 服務器集成了 Jina AI 的神經搜索功能，提供語義、圖像和跨模態搜索。以下是使用前的準備和操作步驟。

✨ 主要特性

• 語義搜索：支持使用自然語言查詢，能精準查找語義相似的文檔。
• 圖像搜索：藉助圖像 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：提供了強大的神經搜索功能
• 社區貢獻者：感謝您的支持和反饋