# Jina AI MCP Tools
A Model Context Protocol (MCP) server that integrates with [Jina AI Search Foundation APIs](https://docs.jina.ai/).
## Features
This MCP server provides access to the following Jina AI APIs:
- **Web Reader** - Extract content from web pages using r.jina.ai
- **Web Search** - Search the web using s.jina.ai or svip.jina.ai (configurable via `--search-endpoint`)
## Prerequisites
1. **Jina AI API Key** (Optional) - Get a free API key from [https://jina.ai/?sui=apikey](https://jina.ai/?sui=apikey) for enhanced features
2. **Node.js** - Version 16 or higher
## MCP Server
### Using stdio Transport (Default)
For local integrations spawned by another process (e.g., Claude Desktop, VS Code, Cursor):
```json
{
"mcpServers": {
"jina-mcp-tools": {
"command": "npx",
"args": [
"jina-mcp-tools",
"--transport", "stdio",
"--tokens-per-page", "15000",
"--search-endpoint", "standard"
],
"env": {
"JINA_API_KEY": "your_jina_api_key_here_optional"
}
}
}
}
```
### Using HTTP Transport
For remote server deployments accessible via HTTP:
**Start the server:**
```bash
# With API key
JINA_API_KEY=your_api_key npx jina-mcp-tools --transport http --port 3000
# Without API key (reader tool only)
npx jina-mcp-tools --transport http --port 3000
```
**Connect from MCP clients:**
- MCP Inspector: `npx @modelcontextprotocol/inspector` → `http://localhost:3000/mcp`
- Claude Code: `claude mcp add --transport http jina-tools http://localhost:3000/mcp`
- VS Code: `code --add-mcp '{"name":"jina-tools","type":"http","url":"http://localhost:3000/mcp"}'`
**CLI Options:**
- `--transport` - Transport type: `stdio` or `http` (default: stdio)
- `--port` - HTTP server port (default: 3000, only for HTTP transport)
- `--tokens-per-page` - Tokens per page for pagination (default: 15000)
- `--search-endpoint` - Search endpoint to use: `standard` (s.jina.ai) or `vip` (svip.jina.ai) (default: standard)
## Available Tools
### jina_reader
Extract and read web page content.
**Parameters:**
- `url` - URL to read (required)
- `page` - Page number for paginated content (default: 1)
- `customTimeout` - Timeout override in seconds (optional)
**Features:**
- Automatic pagination for large documents
- LRU cache (50 URLs) for instant subsequent page requests
- GitHub file URLs automatically converted to raw content URLs
### jina_search / jina_search_vip
Search the web. Returns partial content; use `jina_reader` for full content. Requires API key.
Tool registered depends on `--search-endpoint`:
- `jina_search` → `standard` (s.jina.ai, default)
- `jina_search_vip` → `vip` (svip.jina.ai)
**Parameters:**
- `query` - Search query (required)
- `count` - Number of results (default: 5)
- `siteFilter` - Limit to specific domain (e.g., "github.com")
## License
MIT
## Links
- GitHub: [https://github.com/PsychArch/jina-mcp-tools](https://github.com/PsychArch/jina-mcp-tools)
- Issues: [https://github.com/PsychArch/jina-mcp-tools/issues](https://github.com/PsychArch/jina-mcp-tools/issues)
