Jina AI MCP Server

by Sheshiyer

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 Server

A Model Context Protocol (MCP) server that provides seamless integration with Jina AI's neural search capabilities. This server enables semantic search, image search, and cross-modal search functionalities through a simple interface.

🚀 Features

  • Semantic Search: Find semantically similar documents using natural language queries
  • Image Search: Search for visually similar images using image URLs
  • Cross-Modal Search: Perform text-to-image or image-to-text searches

📋 Prerequisites

  • Node.js 16 or higher
  • A Jina AI account and API key (Get one here)
  • MCP-compatible environment (e.g., Cline)

🛠️ Installation

  1. Clone the repository:
git clone <repository-url> cd jina-ai-mcp
  1. Install dependencies:
npm install
  1. Create a .env file with your Jina AI API key:
JINA_API_KEY=your_api_key_here
  1. Build the server:
npm run build

⚙️ Configuration

Add the following configuration to your MCP settings file:

{ "mcpServers": { "jina-ai": { "command": "node", "args": [ "/path/to/jina-ai-mcp/build/index.js" ], "env": { "JINA_API_KEY": "your_api_key_here" } } } }

🔍 Available Tools

Perform semantic/neural search on text documents.

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

Search for similar images using an image 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 } })

Perform text-to-image or image-to-text search.

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

📝 Response Format

All search tools return results in the following format:

{ content: [ { type: "text", text: JSON.stringify({ results: [ { id: string, score: number, data: Record<string, any> } ] }, null, 2) } ] }

🔐 Error Handling

The server handles various error cases:

  • Invalid API key
  • Missing or invalid parameters
  • API rate limits
  • Network errors
  • Invalid collection names

All errors are properly formatted and returned with appropriate error codes and messages.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

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

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.

Enables semantic search, image search, and cross-modal search functionalities through integration with Jina AI's neural search capabilities.

  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

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      Enables AI assistants to download images from URLs and perform basic image optimization tasks.
                      Last updated -
                      2
                      4
                      JavaScript
                      Apache 2.0
                    • A
                      security
                      A
                      license
                      A
                      quality
                      Enables efficient web search integration with Jina.ai's Search API, offering clean, LLM-optimized content retrieval with support for various content types and configurable caching.
                      Last updated -
                      1
                      22
                      3
                      JavaScript
                      MIT License
                    • A
                      security
                      A
                      license
                      A
                      quality
                      Facilitates integration of Brave Search functionalities with AI assistants through the Model Context Protocol, enabling web and local searches using the Brave Search API.
                      Last updated -
                      2
                      4
                      Python
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      Enables AI models to search, retrieve, and utilize GIFs from Giphy with features like content filtering, multiple search methods, and comprehensive metadata.
                      Last updated -
                      TypeScript
                      MIT License

                    View all related MCP servers

                    ID: pekvpd5qjt