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

Clone the repository:

git clone <repository-url>
cd jina-ai-mcp

Install dependencies:

npm install

Create a .env file with your Jina AI API key:

JINA_API_KEY=your_api_key_here

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

1. Semantic Search

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

2. Image Search

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

Jina AI for their excellent neural search platform
Model Context Protocol for the MCP specification

This server cannot be installed

security - not tested

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-image-downloader
qpd-v
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
MCP JinaAI Search Server
spences10
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
Brave Search MCP Server
arben-adm
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
MCP Server Giphy
magarcia
-
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 -
63
8
TypeScript
MIT License

View all related MCP servers

Jina AI MCP Server