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.

📋 Table of Contents

• ✨ Features
• 🔧 How it Works
• ⚡ Quick Start
• 📦 Installation
• ⚙️ Configuration
• 🔌 MCP Server Setup
• 💡 Usage Examples
• 📚 API Documentation
• 🛠️ Development
• 🤝 Contributing
• 💬 Support
• 📄 License

✨ 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

1. For Claude Desktop: Add the configuration to your claude_desktop_config.json file
2. Replace API Key: Use your actual Jina AI API key
3. 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

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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

• 🌐 Jina AI Website
• 📋 Model Context Protocol
• 🖥️ Claude Desktop

---

<div align="center">

Made with ❤️ by Meet Patel

⭐ Star this repo if you find it helpful! ⭐

</div>