Jina AI MCP-Tools

Ein Model Context Protocol (MCP) Server, der in die Jina AI Search Foundation APIs integriert ist.

Funktionen

Dieser MCP-Server bietet Zugriff auf die folgenden Jina AI APIs:

• Web Reader - Extrahiert Inhalte von Webseiten mittels r.jina.ai

• Web Search - Durchsucht das Web mittels s.jina.ai oder svip.jina.ai (konfigurierbar über --search-endpoint)

Related MCP server: Jina Web Search MCP

Voraussetzungen

1. Jina AI API-Schlüssel (Optional) - Erhalten Sie einen kostenlosen API-Schlüssel unter https://jina.ai/?sui=apikey für erweiterte Funktionen

2. Node.js - Version 16 oder höher

MCP-Server

Verwendung des stdio-Transports (Standard)

Für lokale Integrationen, die von einem anderen Prozess gestartet werden (z. B. 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"
      }
    }
  }
}

Verwendung des HTTP-Transports

Für Remote-Server-Bereitstellungen, die über HTTP zugänglich sind:

Server starten:

# With API key
JINA_API_KEY=your_api_key npx jina-mcp-tools --transport http --host 127.0.0.1 --port 3000

# Without API key (reader tool only, binds to 127.0.0.1 by default)
npx jina-mcp-tools --transport http --port 3000

Verbindung von 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-Optionen:

• --transport - Transporttyp: stdio oder http (Standard: stdio)

• --host - Host/Schnittstelle für die Bindung im HTTP-Modus (Standard: 127.0.0.1)

• --port - HTTP-Server-Port (Standard: 3000, nur für HTTP-Transport)

• --tokens-per-page - Token pro Seite für die Paginierung (Standard: 15000)

• --search-endpoint - Zu verwendender Such-Endpunkt: standard (s.jina.ai) oder vip (svip.jina.ai) (Standard: standard)

• --cache-size - Reader-Cache-Größe in URLs (Standard: 50)

• --help - Zeigt die integrierte CLI-Hilfe an

Proxy-Umgebungsvariablen

Ausgehende HTTP-Anfragen berücksichtigen jetzt standardmäßige Proxy-Umgebungsvariablen. Dies gilt für jina_reader, jina_search und jina_search_vip.

• Unterstützte Proxy-Variablen: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY

• Kleingeschriebene Varianten werden ebenfalls unterstützt: http_proxy, https_proxy, all_proxy

• Ausschlüsse werden über NO_PROXY / no_proxy respektiert

Beispiel:

HTTPS_PROXY=http://proxy.internal:8080 npx jina-mcp-tools --transport stdio

Verfügbare Tools

jina_reader

Extrahiert und liest Webseiteninhalte.

Parameter:

• url - Zu lesende URL (erforderlich)

• page - Seitennummer für paginierte Inhalte (Standard: 1)

• customTimeout - Timeout-Überschreibung in Sekunden (optional)

Funktionen:

• Automatische Paginierung für große Dokumente

• LRU-Cache (50 URLs) für sofortige nachfolgende Seitenanfragen

• GitHub-Datei-URLs werden automatisch in Raw-Content-URLs konvertiert

• Versucht zuerst Accept: text/markdown für eine gepflegte Positivliste von Markdown-fähigen Dokumenten-/Blog-Hosts und greift bei Abruffehlern oder leeren Antworten auf r.jina.ai zurück

jina_search / jina_search_vip

Durchsucht das Web. Gibt teilweise Inhalte zurück; verwenden Sie jina_reader für vollständige Inhalte. Erfordert einen API-Schlüssel.

Das registrierte Tool hängt von --search-endpoint ab:

• jina_search → standard (s.jina.ai, Standard)

• jina_search_vip → vip (svip.jina.ai)

Parameter:

• query - Suchanfrage (erforderlich)

• count - Anzahl der Ergebnisse (Standard: 5)

• siteFilter - Auf eine bestimmte Domain beschränken (z. B. "github.com")

Lizenz

MIT

Links

• GitHub: https://github.com/PsychArch/jina-mcp-tools

• Issues: https://github.com/PsychArch/jina-mcp-tools/issues