A
securityA
licenseA
qualityEnables 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 -
9
3
MIT License
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
Clone the repository:
git clone <repository-url>
cd jina-ai-mcp
Install dependencies:
npm install
Create a
.envfile 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
}
})
3. Cross-Modal Search
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
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.
- 🚀 Features
- 📋 Prerequisites
- 🛠️ Installation
- ⚙️ Configuration
- 🔍 Available Tools
- 📝 Response Format
- 🔐 Error Handling
- 🤝 Contributing
- 📄 License
- 🙏 Acknowledgments
Related Resources
Related MCP Servers
- -securityAlicense-qualityEnables web content retrieval and semantic search capabilities through the Jina AI API. Provides tools to fetch content from URLs and perform intelligent web searches with natural language queries.Last updated -3MIT License
Jina AI Remote MCP Serverofficial
AsecurityAlicenseAqualityEnables web content extraction, screenshot capture, web search, arXiv paper search, and image search through Jina AI's APIs. Provides tools for reading URLs as markdown, searching the web for current information, and finding academic papers or images.Last updated -15147Apache 2.0- -securityAlicense-qualityProvides access to Jina AI's suite of web tools including URL reading, web/image/academic search, content extraction, embeddings, and reranking capabilities. Enables AI assistants to search the web, extract content from URLs, and process information with semantic understanding.Last updated -15Apache 2.0