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
Related MCP server: Jina Web Search MCP
📋 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:
Install dependencies:
Create a
.envfile with your Jina AI API key:
Build the server:
⚙️ Configuration
Add the following configuration to your MCP settings file:
🔍 Available Tools
1. Semantic Search
Perform semantic/neural search on text documents.
2. Image Search
Search for similar images using an image URL.
3. Cross-Modal Search
Perform text-to-image or image-to-text search.
📝 Response Format
All search tools return results in the following format:
🔐 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