Skip to content

thevibeworks/jina-mcp-server

 
 

Repository files navigation

Jina AI Remote MCP Server

A remote Model Context Protocol (MCP) server that provides access to Jina Reader, Embeddings and Reranker APIs with a suite of URL-to-markdown, web search, image search, and embeddings/reranker tools:

Tool Description Is Jina API Key Required?
read_url Extract clean, structured content from web pages as markdown via Reader API Optional*
capture_screenshot_url Capture high-quality screenshots of web pages via Reader API Optional*
search_web Search the entire web for current information and news via Reader API Yes
search_arxiv Search academic papers and preprints on arXiv repository via Reader API Yes
search_image Search for images across the web (similar to Google Images) via Reader API Yes
sort_by_relevance Rerank documents by relevance to a query via Reranker API Yes
deduplicate_strings Get top-k semantically unique strings via Embeddings API and submodular optimization Yes
deduplicate_images Get top-k semantically unique images via Embeddings API and submodular optimization Yes

Optional tools work without an API key but have rate limits. For higher rate limits and better performance, use a Jina API key. You can get a free Jina API key from https://jina.ai

Usage

For client that supports remote MCP server:

{
  "mcpServers": {
    "jina-mcp-server": {
      "url": "https://mcp.jina.ai/sse",
      "headers": {
        "Authorization": "Bearer ${JINA_API_KEY}" // optional
      }
    }
  }
}

For client that does not support remote MCP server yet, you need mcp-remote a local proxy to connect to the remote MCP server.

{
  "mcpServers": {
    "jina-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote", 
        "https://mcp.jina.ai/sse"
        // optional bearer token
        "--header",
        "Authorization: Bearer ${JINA_API_KEY}"
        ]
    }
  }
}

Developer Guide

Local Development

# Clone the repository
git clone https://github.com/jina-ai/MCP.git
cd MCP

# Install dependencies
npm install

# Start development server
npm run start

Deploy to Cloudflare Workers

Deploy to Workers

This will deploy your MCP server to a URL like: jina-mcp-server.<your-account>.workers.dev/sse

About

Official Jina AI Remote MCP Server

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 100.0%