Jina AI Search MCP Server

🚀 Quick Start: Try it instantly with Claude Desktop using our hosted endpoint: https://jina-mcp.onrender.com/sse

A powerful Model Context Protocol (MCP) server implementation that provides seamless access to Jina AI's Search Foundation API. This server enables AI assistants and applications to leverage Jina's advanced search, reading, and knowledge retrieval capabilities through a standardized MCP interface.

✨ Features

🚀 MCP-compliant server implementation - Full compatibility with Model Context Protocol
🔍 Jina AI Search & Reader APIs - Access to powerful AI search and content reading capabilities
📚 DeepWiki Integration - Enhanced Wikipedia access with AI understanding
🏗️ Clean, modular codebase - Well-structured and maintainable architecture
📖 Comprehensive documentation - Detailed guides and API references
⚡ Easy setup - Simple installation with virtual environment support
🔐 Secure authentication - OAuth2 Bearer token support
🌐 Real-time processing - Server-Sent Events (SSE) for live communication

🔧 How it Works

The Jina MCP server provides seamless integration with Jina AI's powerful search and reading capabilities through the Model Context Protocol. Here's how you can leverage its features:

🔍 Search with Jina AI

Ask questions and get comprehensive search results from across the web:

"Search for the latest developments in artificial intelligence"
"Find information about sustainable energy solutions"
"What are the recent breakthroughs in quantum computing?"

🎯 Use Cases

Research assistance - Get comprehensive information on any topic
Content analysis - Read and analyze web pages
Knowledge discovery - Explore Wikipedia with AI-enhanced understanding
AI assistant integration - Seamlessly integrate with Claude Desktop and other MCP clients

⚡ Quick Start

Prerequisites

Python 3.8+
pip package manager
Jina AI API Key (Get yours here)

Instant Setup with Claude Desktop

Add this configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "jina": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "supergateway",
        "--sse",
        "https://jina-mcp.onrender.com/sse",
        "--oauth2Bearer=your-jina-api-key"
      ]
    }
  }
}

Replace your-jina-api-key with your actual Jina AI API key and restart Claude Desktop!

📦 Installation

1. Clone the Repository

git clone https://github.com/Meetpatel006/jina-mcp.git
cd jina-mcp

2. Set Up Virtual Environment

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

⚙️ Configuration

Environment Setup

Create a .env file in the project root:

JINA_API_KEY=your_jina_api_key_here

Running the Server Locally

python -m jina_mcp.server

🔌 MCP Server Setup

For Claude Desktop (Recommended)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jina": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "supergateway",
        "--sse",
        "https://jina-mcp.onrender.com/sse",
        "--oauth2Bearer=your-jina-api-key"
      ]
    }
  }
}

Local Development Setup

For local development:

{
  "mcpServers": {
    "jina": {
      "command": "python",
      "args": ["-m", "jina_mcp.server"],
      "cwd": "/path/to/jina-mcp",
      "env": {
        "JINA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuration Steps

For Claude Desktop: Add the configuration to your claude_desktop_config.json file
Replace API Key: Use your actual Jina AI API key
Restart Client: Restart your MCP client to load the new server

💡 Usage Examples

Basic Search

# Search for information
"Search for Python best practices"
"Find the latest news about AI development"

DeepWiki Queries

# Ask deepwiki for detailed information
"Ask deepwiki about machine learning"
"Ask deepwiki to explain neural networks"
"Ask deepwiki about the Python programming language"

Web Content Analysis

# Read and analyze web content
"Read https://example.com/blog-post"
"Summarize the content from https://research-paper-url.com"

📚 API Documentation

Documentation Resources

📖 API Documentation - Complete API reference
🔧 MCP Protocol Documentation - MCP implementation details
🐍 Python SDK Documentation - Python SDK usage
🔍 Jina API Documentation - Jina AI API reference

Code Examples

Explore the examples directory:

🔧 Client Example - Basic client implementation
More examples coming soon!

🛠️ Development

Development Setup

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

# Code formatting
black .

# Linting
flake8 .

Project Structure

jina-mcp/
├── jina_mcp/           # Main package
│   ├── __init__.py
│   ├── server.py       # MCP server implementation
│   ├── client.py       # Jina API client
│   ├── config.py       # Configuration management
│   ├── models.py       # Data models
│   └── tools.py        # MCP tools
├── docs/               # Documentation
├── examples/           # Usage examples
├── requirements.txt    # Dependencies
└── README.md          # This file

🤝 Contributing

We welcome contributions! Here's how you can help:

How to Contribute

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Contribution Guidelines

Follow the existing code style (use black for formatting)
Add tests for new features
Update documentation as needed
Ensure all tests pass before submitting

💬 Support

Get Help

📖 Documentation - Comprehensive guides and references
🐛 Issue Tracker - Report bugs or request features
💬 Discussions - Community discussions
📧 Contact: Create an issue for support

Useful Links

Made with ❤️ by Meet Patel

⭐ Star this repo if you find it helpful! ⭐