mcp-jina-ai

by joeBlockchain

17 stars

1 downloads

Not rated

GitHub

About

An MCP server that provides access to Jina AI's powerful web services (page reading, web search, fact checking) through Claude.

Details

Author: joeBlockchain
Repository: JoeBuildsStuff/mcp-jina-ai
GitHub stars: 17
Downloads: 1
License: MIT License
Categories: AI, Search

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name mcp-jina-ai

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 jina-ai-mcp-server
Environment
- JINA_API_KEY <YOUR_KEY>
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

There are two ways to use this server:

To install Jina AI for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install jina-ai-mcp-server --client claude

1. Clone the repository
2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Add this configuration to your Claude Desktop config:

{

  "mcpServers": {

    "jina-ai-mcp-server": {

      "command": "node",

      "args": [

        "/path/to/jina-ai-mcp-server/dist/index.js"

      ],

      "env": {

        "JINA_API_KEY": "<YOUR_KEY>"

      }

    }

  }

}

On MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts index.ts

`read_webpage`

Extract content from web pages in a format optimized for LLMs. Supports multiple output formats (Default, Markdown, HTML, Text, Screenshot, Pageshot) and options for including links and images, generating alt text for images, and cache control.

`search_web`

Search the web using Jina AI's search API. Configurable number of results (default: 5), supports image retention and alt text generation, and returns structured results with titles, descriptions, and content in multiple formats (markdown, text, html).

`fact_check`

Fact-check statements using Jina AI's grounding engine. Provides factuality scores and supporting evidence, with an optional deep-dive mode for thorough analysis, returning references with key quotes and supportive/contradictory classification.

`read_webpage`

- Extract content from web pages in a format optimized for LLMs - Supports multiple output formats (Default, Markdown, HTML, Text, Screenshot, Pageshot) - Options for including links and images - Ability to generate alt text for images - Cache control options

`search_web`

- Search the web using Jina AI's search API - Configurable number of results (default: 5) - Support for image retention and alt text generation - Multiple return formats (markdown, text, html) - Returns structured results with titles, descriptions, and content

`fact_check`

- Fact-check statements using Jina AI's grounding engine - Provides factuality scores and supporting evidence - Optional deep-dive mode for more thorough analysis - Returns references with key quotes and supportive/contradictory classification

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-jina-ai": {
            "env": {
                "JINA_API_KEY": "<YOUR_KEY>"
            },
            "args": [
                "-y",
                "jina-ai-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
    },
    "args": [
        "-y",
        "jina-ai-mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
    },
    "args": [
        "-y",
        "jina-ai-mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
    },
    "args": [
        "-y",
        "jina-ai-mcp-server"
    ],
    "command": "npx"
}

Jina AI MCP Server

An MCP server that provides access to Jina AI's powerful web services through Claude. This server implements three main tools:

- Web page reading and content extraction
- Web search
- Fact checking/grounding

Features

Tools

`read_webpage`

`search_web`

`fact_check`

Setup

Prerequisites

You'll need a Jina AI API key to use this server. Get one for free at https://jina.ai/

Installation

There are two ways to use this server:

Installing via Smithery

To install Jina AI for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install jina-ai-mcp-server --client claude

Option 1: NPX (Recommended)

Add this configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "jina-ai-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "jina-ai-mcp-server"
      ],
      "env": {
        "JINA_API_KEY": "<YOUR_KEY>"
      }
    }
  }
}

Option 2: Local Installation

1. Clone the repository 2. Install dependencies:

npm install

3. Build the server:

npm run build

4. Add this configuration to your Claude Desktop config:

{

  "mcpServers": {

    "jina-ai-mcp-server": {

      "command": "node",

      "args": [

        "/path/to/jina-ai-mcp-server/dist/index.js"

      ],

      "env": {

        "JINA_API_KEY": "<YOUR_KEY>"

      }

    }

  }

}

Config File Location

On MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows:

%APPDATA%/Claude/claude_desktop_config.json

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

API Response Types

All tools return structured JSON responses that include:

- Status codes and metadata
- Formatted content based on the requested output type
- Usage information (token counts)
- When applicable: images, links, and additional metadata

For detailed schema information, see schemas.ts.

Running evals

OPENAI_API_KEY=your-key  npx mcp-eval evals.ts index.ts

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

read_webpage

search_web

fact_check

read_webpage

search_web

fact_check

Claude Desktop / Cursor

Linux

Macos

Windows

Jina AI MCP Server

Features

Tools

read_webpage

search_web

fact_check

Setup

Prerequisites

Installation

Installing via Smithery

Option 1: NPX (Recommended)

Option 2: Local Installation

Config File Location

Debugging

API Response Types

Running evals

Install

More like this

Brave Search

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

`read_webpage`

`search_web`

`fact_check`

`read_webpage`

`search_web`

`fact_check`

`read_webpage`

`search_web`

`fact_check`