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

How are these scores calculated?

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

Google Custom Search Engine MCP Server
Richard-Weiss
A
security
A
license
A
quality
Enables search capabilities using a Google Custom Search Engine, allowing users to input a search term and retrieve search result titles, links, and snippets, while facilitating integration with other tools for content extraction and advanced search strategies.
Last updated -
1
29
Python
The Unlicense
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
419
4
JavaScript
MIT License
AI Agent Marketplace Index Search
AI-Agent-Hub
-
security
F
license
-
quality
Enables searching for AI agents by keywords or categories, allowing users to discover tools like coding agents, GUI agents, or industry-specific assistants across marketplaces.
Last updated -
34
Python
MCP Gemini Google Search
yukukotani
A
security
A
license
A
quality
Provides Google Search functionality for AI models using Gemini's built-in Grounding with Google Search feature, returning real-time web search results with source citations.
Last updated -
1
547
60
TypeScript
Apache 2.0

View all related MCP servers

Jina AI MCP Server