Jina AI MCP Tools

Integrates with Jina AI APIs for web reading, search, and fact-checking.

GitHub

Jina AI MCP Tools

A Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

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 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):

{
  "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:

# 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

Servidores relacionados