MCP JinaAI Search Server

mcp-jinaai-search

⚠️ Notice

This repository is no longer maintained.

The functionality of this tool is now available in mcp-omnisearch, which combines multiple MCP tools in one unified package.

Please use mcp-omnisearch instead.

A Model Context Protocol (MCP) server for integrating Jina.ai's Search API with LLMs. This server provides efficient and comprehensive web search capabilities, optimised for retrieving clean, LLM-friendly content from the web.

Features

🔍 Advanced web search through Jina.ai Search API
🚀 Fast and efficient content retrieval
📄 Clean text extraction with preserved structure
🧠 Content optimised for LLMs
🌐 Support for various content types including documentation
🏗️ Built on the Model Context Protocol
🔄 Configurable caching for performance
🖼️ Optional image and link gathering
🌍 Localisation support through browser locale
🎯 Token budget control for response size

Configuration

This server requires configuration through your MCP client. Here are examples for different environments:

Cline Configuration

Add this to your Cline MCP settings:

{
	"mcpServers": {
		"jinaai-search": {
			"command": "node",
			"args": ["-y", "mcp-jinaai-search"],
			"env": {
				"JINAAI_API_KEY": "your-jinaai-api-key"
			}
		}
	}
}

Claude Desktop with WSL Configuration

For WSL environments, add this to your Claude Desktop configuration:

{
	"mcpServers": {
		"jinaai-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"JINAAI_API_KEY=your-jinaai-api-key npx mcp-jinaai-search"
			]
		}
	}
}

Environment Variables

The server requires the following environment variable:

JINAAI_API_KEY: Your Jina.ai API key (required)

API

The server implements a single MCP tool with configurable parameters:

search

Search the web and get clean, LLM-friendly content using Jina.ai Reader. Returns top 5 results with URLs and clean content.

Parameters:

query (string, required): Search query
format (string, optional): Response format ("json" or "text"). Defaults to "text"
no_cache (boolean, optional): Bypass cache for fresh results. Defaults to false
token_budget (number, optional): Maximum number of tokens for this request
browser_locale (string, optional): Browser locale for rendering content
stream (boolean, optional): Enable stream mode for large pages. Defaults to false
gather_links (boolean, optional): Gather all links at the end of response. Defaults to false
gather_images (boolean, optional): Gather all images at the end of response. Defaults to false
image_caption (boolean, optional): Caption images in the content. Defaults to false
enable_iframe (boolean, optional): Extract content from iframes. Defaults to false
enable_shadow_dom (boolean, optional): Extract content from shadow DOM. Defaults to false
resolve_redirects (boolean, optional): Follow redirect chains to final URL. Defaults to true

Development

Setup

Clone the repository
Install dependencies:

pnpm install

Build the project:

pnpm run build

Run in development mode:

pnpm run dev

Publishing

Create a changeset:

pnpm changeset

Version the package:

pnpm version

Build and publish:

pnpm release

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Acknowledgments

Built on the Model Context Protocol
Powered by Jina.ai Search API

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

Enables 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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-jina-ai
JoeBuildsStuff
A
security
A
license
A
quality
An MCP server that provides access to Jina AI's powerful web services (page reading, web search, fact checking) through Claude.
Last updated -
3
189
12
JavaScript
MIT License
MCP Tavily Search Server
spences10
A
security
A
license
A
quality
Integrates Tavily's search API with LLMs to provide advanced web search capabilities, including intelligent result summaries, domain filtering for quality control, and configurable search parameters.
Last updated -
3
64
9
JavaScript
MIT License
MCP JinaAI Reader Server
spences10
A
security
A
license
A
quality
Integrates Jina.ai's Reader API with LLMs for efficient and structured web content extraction, optimized for documentation and web content analysis.
Last updated -
1
24
24
JavaScript
MIT License
Tavily MCP Server with Proxy Support
tulong66
-
security
F
license
-
quality
Enables LLMs to perform sophisticated web searches through proxy servers using Tavily's API, supporting comprehensive web searches, direct question answering, and recent news article retrieval with AI-extracted content.
Last updated -
1
Python

View all related MCP servers

MCP JinaAI Search Server