Jina Ai MCP Multimodal Search

🚀 Jina AI MCP サーバー

Jina AI のニューラル検索機能とシームレスに統合されたモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、簡単なインターフェースを通じて、意味検索、画像検索、クロスモーダル検索機能を提供します。

🚀 クイックスタート

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"
      }
    }
  }
}

利用可能なツール

意味検索

テキストドキュメントに対して意味/ニューラル検索を実行します。

use_mcp_tool({
  server_name: "jina-ai",
  tool_name: "semantic_search",
  arguments: {
    query: "検索クエリテキスト",
    collection: "your-collection-name",
    limit: 10 // オプション、デフォルトは 10
  }
})

画像検索

画像の 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
  }
})

クロスモーダル検索

テキストから画像、または画像からテキストの検索を実行します。

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：強力なニューラル検索機能を提供してくれました。
• コミュニティの貢献者：皆様のサポートとフィードバックに感謝します。