Jina AI MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Used for loading API key from environment variables, allowing secure configuration of the Jina AI integration

  • Serves as the runtime environment for the MCP server, executing the Jina AI integration

  • Used for defining tool signatures and response formats when interacting with Jina AI's neural search capabilities

Jina AI MCP サーバー

Jina AIのニューラル検索機能とのシームレスな統合を実現するモデルコンテキストプロトコル(MCP)サーバー。シンプルなインターフェースを通じて、セマンティック検索、画像検索、クロスモーダル検索機能を実現します。

🚀 機能

  • セマンティック検索:自然言語クエリを使用して意味的に類似した文書を検索します
  • 画像検索: 画像のURLを使用して視覚的に類似した画像を検索します
  • クロスモーダル検索: テキストから画像、または画像からテキストへの検索を実行します

📋 前提条件

  • Node.js 16以上
  • Jina AI アカウントと API キー (こちらから取得)
  • MCP互換環境(例:Cline)

🛠️ インストール

  1. リポジトリをクローンします。
git clone <repository-url> cd jina-ai-mcp
  1. 依存関係をインストールします:
npm install
  1. Jina AI API キーを使用して.envファイルを作成します。
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<string, any> } ] }, null, 2) } ] }

🔐 エラー処理

サーバーはさまざまなエラーケースを処理します。

  • 無効なAPIキー
  • パラメータが不足しているか無効です
  • API レート制限
  • ネットワークエラー
  • 無効なコレクション名

すべてのエラーは適切にフォーマットされ、適切なエラー コードとメッセージとともに返されます。

🤝 貢献する

貢献を歓迎します!お気軽にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

-
security - not tested
A
license - permissive license
-
quality - not tested

Jina AI のニューラル検索機能との統合により、セマンティック検索、画像検索、クロスモーダル検索機能を有効にします。

  1. 🚀 Features
    1. 📋 Prerequisites
      1. 🛠️ Installation
        1. ⚙️ Configuration
          1. 🔍 Available Tools
            1. 1. Semantic Search
            2. 2. Image Search
            3. 3. Cross-Modal Search
          2. 📝 Response Format
            1. 🔐 Error Handling
              1. 🤝 Contributing
                1. 📄 License
                  1. 🙏 Acknowledgments
                    ID: pekvpd5qjt