Jina AI MCP Tools

Jina AI MCP Tools

コーディングエージェント向けのウェブ検索とページ読み込み。ツールは2つだけ。ツールカタログの盛り合わせはありません。

jina-mcp-tools は、Jina AI Reader and Search を基盤に構築された、非公式で意図的に小規模な Model Context Protocol (MCP) サーバーです。

Codex、Claude Code、その他のコーディングエージェントに、プログラミング中に通常必要となる次の2つのウェブ機能を提供します。

• 関連性の高いページを少数見つけます。
• 実際に重要なページを読み込みます。

メニューはこれだけです。埋め込み、スクリーンショット、画像検索、分類、再ランキング、PDFの探索はありません。どれも便利なツールですが、コーディングセッションのたびに持ち込む必要があるとは限りません。

メモ

これは非公式のコミュニティプロジェクトです。Jina AI との提携関係や、Jina AI からの推奨はなく、Jina AI API を置き換えるのではなく利用します。

Jina の別の統合が必要な理由

Jina はすでに、優れた公式 MCP サーバーと公式 CLIを提供しています。これらは、幅広い Jina の機能を利用できるように設計されています。このプロジェクトは異なるトレードオフを採用し、コンテキスト領域とツール選択に必要な注意力を節約すべきリソースとして扱います。

MCP のツール定義は通常、実際の作業が始まる前にエージェントのコンテキストに入ります。幅広いカタログは必要なときには役立ちますが、日常的なプログラミング調査では、食事よりメニューのほうが多くなってしまうことがあります。jina-mcp-tools が公開するツールは最大2つで、意図的にシンプルな次のワークフローに従います。

1. ウェブを検索して、短い結果一覧を取得します。
2. 役立つ URL を選びます。
3. それらのページを、1ページずつ無理のない単位で読み込みます。
4. コードに戻ります。

退屈なインフラストラクチャは、多くの場合、とても気の利いたインフラストラクチャです。

どの Jina 統合を使えばよいですか？

	jina-mcp-tools	Jina 公式 MCP	Jina 公式 CLI
インターフェース	stdio／HTTP 経由のローカルまたはセルフホスト可能な MCP	ホスト型のリモート MCP	シェルコマンド
デフォルトの対象範囲	ウェブ検索とページ読み込み	幅広い Jina ツールカタログ	幅広い Jina コマンドスイート
コンテキストへの配慮	小規模なツール定義は最大2つ	サーバー側のツールフィルターを利用可能	エージェント既存のシェルツールと段階的な --help を使用
大きなページ	LRU キャッシュを使った明示的なトークン単位のページ分割	クライアントに応じたレスポンスのガードレール	標準出力と Unix パイプ
最適な用途	小規模なネイティブ MCP サーフェスを求めるコーディングエージェント	ホスト型アクセス、調査ツール、画像、PDF、埋め込み、再ランキング	パイプ、JSON、スクリプト、幅広い Jina プラットフォームを求めるエージェントや人間

ネイティブ MCP 統合、最小限のデフォルトツールサーフェス、ページ分割された読み込みを重視する場合は、jina-mcp-tools を選んでください。

ホスト型エンドポイントを利用したい場合や、より幅広い機能が必要な場合は、公式 MCP サーバーを選んでください。include_tools または include_tags で対象を絞ることもできます。ローカルプロセスの実行よりホスティングの利便性を重視する場合に適した選択肢です。

エージェントがすでに信頼できるシェルアクセスを利用でき、大規模な MCP カタログを登録せずに Unix のコマンド連携や Jina API スイート全体を使いたい場合は、公式 CLI を選んでください。

MCP プロトコルの互換性

同じサーバーが、stdio と Streamable HTTP の両方で、現在の MCP 2026-07-28 プロトコルと、従来の初期化方式のクライアントをサポートします。最新のクライアントは server/discover とリクエストごとのプロトコルメタデータを利用できます。古いクライアントも、SDK の従来互換パスを通じて引き続き動作します。

MCP のカーソルページネーションは、tools/list や resources/list などのディスカバリー操作に適用されます。jina_reader の page パラメーターは、アプリケーションレベルでコンテンツを分割する別の仕組みです。これにより、MCP が自動ではページネーションしない tools/call の結果が、大きなドキュメントによって過大になるのを防ぎます。

クイックスタート

前提条件

• Node.js 20 以降。
• ウェブ検索には Jina AI API キーが必要です。リーダーはキーなしでも利用できますが、Jina の未認証時のレート制限が適用されます。

検索と読み取りの両方を利用する場合は、シェルで API キーを設定します。

export JINA_API_KEY=jina_your_api_key

Codex

codex mcp add jina-web --env JINA_API_KEY="$JINA_API_KEY" -- npx -y jina-mcp-tools

Claude Code

claude mcp add --scope user \
  --env JINA_API_KEY="$JINA_API_KEY" \
  --transport stdio jina-web -- npx -y jina-mcp-tools

リーダーのみのモードでは、どちらのコマンドからも API キーのオプションを省略してください。

VS Code

VS Code は MCP 設定を、ユーザープロファイルの mcp.json またはワークスペースレベルの .vscode/mcp.json に保存します。設定では mcpServers ではなく servers を使用します。この例では、API キーの入力を安全に求め、VS Code の入力変数サポートを使って保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "jina-api-key",
      "description": "Jina AI API key",
      "password": true
    }
  ],
  "servers": {
    "jina-web": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "jina-mcp-tools"],
      "env": {
        "JINA_API_KEY": "${input:jina-api-key}"
      }
    }
  }
}

MCP: Open User Configuration を選択してユーザー設定を開くか、ファイルを .vscode/mcp.json として保存して、サーバー設定をワークスペースで共有します。リーダーのみのモードでは env と inputs を削除してください。

コマンドラインからリーダーのみをユーザープロファイルにインストールする場合：

code --add-mcp "{\"name\":\"jina-web\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"jina-mcp-tools\"]}"

Claude Desktop、Cursor、その他の MCP クライアント

mcpServers JSON 形式を使用するクライアントの場合：

{
  "mcpServers": {
    "jina-web": {
      "command": "npx",
      "args": [
        "-y",
        "jina-mcp-tools"
      ],
      "env": {
        "JINA_API_KEY": "your_jina_api_key_here"
      }
    }
  }
}

デフォルトのトランスポートは stdio です。リーダーのみのモードでは env ブロックを削除してください。

利用可能なツール

jina_reader

ウェブページのコンテンツを抽出して読み取ります。

パラメーター：

• url — 読み取る URL（必須）。
• page — ページ分割されたコンテンツのページ番号（デフォルト：1）。
• customTimeout — タイムアウトの秒数を指定します（任意）。

コーディングエージェントによる調査向けに設計されています。

• 巨大な応答を一度に返す代わりに、大きなドキュメントを自動的にページ分割します。
• LRU キャッシュを保持するため、同じ URL の後続ページをすぐに利用できます。
• ブランチ、タグ、コミットを含む GitHub のファイル URL を raw コンテンツの URL に変換します。
• ドキュメントおよびブログの許可リストに登録されたホストでは、まず Accept: text/markdown による直接取得を試み、応答に失敗した場合や空だった場合は r.jina.ai にフォールバックします。

デフォルトのキャッシュには 50 個の URL が保持され、各ページの長さは約 15,000 トークンに制限されます。どちらの値も設定可能です。

jina_search / jina_search_vip

ウェブを検索し、簡潔な候補リストを返します。有望な結果の全文を取得するには jina_reader を使用してください。Jina API キーが必要です。

--search-endpoint に応じて、検索ツールは 1 つだけ登録されます。

• jina_search は s.jina.ai を使用します（standard、デフォルト）。
• jina_search_vip は svip.jina.ai を使用します（vip）。

パラメーター：

• query — 検索クエリ（必須）。
• count — 結果の件数（デフォルト：5）。
• siteFilter — github.com などのドメインに結果を絞り込みます。

デフォルトの結果件数が少ないのは意図的です。まず検索し、必要なものだけを選んで読み取り、最初に作業していたリポジトリのためのコンテキストを残しましょう。

設定

Usage: jina-mcp-tools [options]

Options:
  --transport <stdio|http>         Transport type (default: stdio)
  --host <host>                    Host/interface in HTTP mode (default: 127.0.0.1)
  --port <1-65535>                 HTTP port (default: 3000)
  --tokens-per-page <positive-int> Tokens per reader page (default: 15000)
  --search-endpoint <standard|vip> Search endpoint (default: standard)
  --cache-size <positive-int>      Reader cache size in URLs (default: 50)
  -h, --help                       Show the built-in help

HTTP トランスポート

HTTP モードは、セルフホスト可能なデプロイや、ローカルの stdio プロセスを起動できないクライアントを対象としています。

サーバーを起動します。

# Search and reader
JINA_API_KEY=your_api_key npx -y jina-mcp-tools \
  --transport http \
  --host 127.0.0.1 \
  --port 3000

# Reader only
npx -y jina-mcp-tools --transport http --port 3000

http://localhost:3000/mcp に接続します。

• Codex：codex mcp add jina-web --url http://localhost:3000/mcp
• Claude Code：claude mcp add --transport http jina-web http://localhost:3000/mcp
• MCP Inspector：npx -y @modelcontextprotocol/inspector
• VS Code：code --add-mcp "{\"name\":\"jina-web\",\"type\":\"http\",\"url\":\"http://localhost:3000/mcp\"}"

HTTP セキュリティ

HTTP モードは、デフォルトで 127.0.0.1 にバインドします。リモートにデプロイする場合は、サーバーを TLS の背後に配置し、ベアラートークンを必須にしてください。

JINA_MCP_HTTP_AUTH_TOKEN=change-me \
JINA_MCP_ALLOWED_HOSTS=mcp.example.com \
  npx -y jina-mcp-tools --transport http --host 0.0.0.0 --port 3000

クライアントは次を送信する必要があります。

Authorization: Bearer change-me

ブラウザーからのリクエストは、デフォルトでローカルホストに制限されています。ブラウザーベースのリモートクライアントを許可するには、JINA_MCP_ALLOWED_ORIGINS に完全なオリジンをカンマ区切りで指定してください。たとえば、https://app.example.com のように指定します。

ループバック HTTP バインドでは、Host ヘッダーが自動的に検証されます。0.0.0.0 または :: にバインドする場合は、サーバーが受け入れる公開ホスト名をカンマ区切りで JINA_MCP_ALLOWED_HOSTS に設定してください。スキームやポートは含めないでください。これにより、DNS リバインディングや予期しないプロキシのホスト名からエンドポイントを保護できます。

MCP プロセスをローカルで実行しても、Jina へのリクエストがオフラインになるわけではありません。検索とほとんどのリーダーリクエストは、引き続き Jina AI サービスを呼び出します。許可リストに登録された一部の Markdown ホストと GitHub のファイル URL は、直接取得される場合があります。

プロキシ環境変数

送信リクエストをプロキシ経由でルーティングするには、Node のプロキシ環境変数サポートを有効にし、プロキシ URL を指定します。

NODE_USE_ENV_PROXY=1 \
HTTP_PROXY=http://127.0.0.1:7890 \
HTTPS_PROXY=http://127.0.0.1:7890 \
NO_PROXY=localhost,127.0.0.1,::1 \
npx -y jina-mcp-tools

mcpServers 設定形式を使用する MCP クライアントでは、同じ環境変数を含めてください。

{
  "mcpServers": {
    "jina-web": {
      "command": "npx",
      "args": ["-y", "jina-mcp-tools"],
      "env": {
        "JINA_API_KEY": "your_jina_api_key_here",
        "NODE_USE_ENV_PROXY": "1",
        "HTTP_PROXY": "http://127.0.0.1:7890",
        "HTTPS_PROXY": "http://127.0.0.1:7890",
        "NO_PROXY": "localhost,127.0.0.1,::1"
      }
    }
  }
}

または、NODE_OPTIONS=--use-env-proxy を指定して Node を起動します。プロキシ URL は、プロキシ環境変数サポートが有効な場合にのみ使用されます。

開発とテスト

pnpm verify を実行すると、本番コードとテストコードの型チェック、ビルド、およびすべてのテストが実行されます。 コンパイル済み MCP トランスポートのテストスイートのみを実行するには、pnpm test:e2e を実行します。このテストでは、レガシーおよび最新のプロトコルネゴシエーションを使用した stdio と HTTP、リーダー／検索の呼び出し、ページネーション、上流へのリクエスト、および実際の API 認証情報を使わないエラー回復を対象としています。 エクスポート済みの JINA_API_KEY を使って、実際の Jina 呼び出しをオプトインで実行するには、pnpm test:live を実行します。 カバレッジ、対象範囲、および実際の Codex クライアントを使ったワークフローについては、テスト計画を参照してください。モジュールの境界と開発／リリース手順については、アーキテクチャとコントリビューションを参照してください。

対象範囲と対象外

このプロジェクトは、Jina API のすべてを公開することを意図していません。埋め込み、再ランキング、分類、スクリーンショット、画像検索や学術検索、クエリ拡張、重複排除、または PDF の構造化抽出が必要な場合には適していません。それらの用途には、公式のMCP サーバーまたはCLIを使用してください。

対象を絞ることが、このプロジェクトの特長です。このサーバーにツールが 20 個も追加され、小さなコックピットのようになってしまったら、何かがひどく間違っています。

ライセンス

MIT

リンク

• GitHub：github.com/PsychArch/jina-mcp-tools
• イシュー：github.com/PsychArch/jina-mcp-tools/issues