Enables configuration management by loading environment variables from a .env file, specifically for storing and accessing the Jina AI API key.
Supports test-driven development for the MCP server with comprehensive testing capabilities to ensure reliability.
Serves as the foundation for the MCP server implementation, requiring Python 3.8+ for running the application.
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:
🎯 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
:
Replace your-jina-api-key
with your actual Jina AI API key and restart Claude Desktop!
📦 Installation
1. Clone the Repository
2. Set Up Virtual Environment
3. Install Dependencies
⚙️ Configuration
Environment Setup
Create a .env
file in the project root:
Running the Server Locally
🔌 MCP Server Setup
For Claude Desktop (Recommended)
Add to your claude_desktop_config.json
:
Local Development Setup
For local development:
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
DeepWiki Queries
Web Content Analysis
📚 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
Project Structure
🤝 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! ⭐
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.
A Model Context Protocol server implementation that provides a standardized interface for interacting with Jina AI's Reader and Search APIs.
Related MCP Servers
- -securityFlicense-qualityA server implementation that allows AI models to interact with Jira through the Model Context Protocol, enabling tasks like JQL searches and retrieving issue details.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that connects AI agents to Apache Jena, enabling them to execute SPARQL queries and updates against RDF data stored in Jena Fuseki.Last updated -TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.Last updated -5872TypeScriptMIT License
- -securityAlicense-qualityA Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.Last updated -1PythonApache 2.0