Context7 MCP Server

Context7 MCP Server とは？

Context7 MCP Server は Upstash 公式の Context7 MCP サーバーです。最新かつバージョンごとのライブラリドキュメントとコード例を AI コーディングアシスタントのコンテキストに取り込み、古い学習データではなく現在の API に基づいた回答を得られるようにします。

Context7 は Upstash が開発しています。MCP サーバーのソースは upstash/context7 リポジトリ（MIT ライセンス）にあり、npm では @upstash/context7-mcp として公開されています。ドキュメントのインデックスを構築する API バックエンド、パースエンジン、クロールエンジンは非公開です。ホスト型のリモートサーバーとしても、ローカルでも利用でき、MCP を使わない CLI + Skills モードもあります。

Context7 MCP Server の使い方

最も手軽なのはセットアップ用 CLI です。Node.js 22.13 以上が必要です。

npx ctx7 setup

OAuth でサインインし、API キーを生成したうえで、CLI + Skills モードと MCP モードのどちらかを選べます。--cursor、--claude、--opencode を付けると特定のエージェントを対象にできます。元に戻すには npx ctx7 remove を実行します。

手動で設定する場合は、リモートサーバーの URL https://mcp.context7.com/mcp を使い、キーを Authorization: Bearer YOUR_API_KEY ヘッダーで送ります。レート制限を引き上げるため、context7.com/dashboard で無料の API キーを取得することが推奨されています。ローカルで動かす場合は npx -y @upstash/context7-mcp --api-key YOUR_API_KEY を使います。

Claude Code

リモート：

claude mcp add --scope user --header "Authorization: Bearer YOUR_API_KEY" \
  --transport http context7 https://mcp.context7.com/mcp

ローカル：

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Claude Desktop

リモートサーバーの場合は Settings > Connectors > Add Custom Connector を開き、名前を Context7、URL を https://mcp.context7.com/mcp にします。ローカルサーバーの場合は claude_desktop_config.json に次を追加します。

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Cursor

~/.cursor/mcp.json に追加します（README にはワンクリックインストールボタンもあります）。

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex

~/.codex/config.toml に追加します。

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }

ほか 30 以上のクライアントの手順は Context7 のクライアント向けドキュメント にあります。

Context7 MCP Server の主な機能

• ライブラリのソースから最新のドキュメントとコード例を直接取得し、プロンプトに挿入します。
• バージョン対応：プロンプトにバージョンを書く（「Next.js 16 proxy」など）と、該当するドキュメントを選びます。
• /supabase/supabase や /vercel/next.js のようなライブラリ ID を指定すると検索ステップを省略できます。
• ホスト型のリモートエンドポイントとローカルの npm パッケージの両方があり、どの MCP クライアントにも対応します。
• MCP を使いたくないエージェント向けの CLI + Skills モード（ctx7 library、ctx7 docs）。
• npx ctx7 setup の 1 コマンドで Cursor、Claude Code、OpenCode をセットアップできます。
• ライブラリのメンテナーは自分のプロジェクトをインデックスに登録できます。

Context7 MCP Server のツール

ツールは最小限の 2 つで、通常は順番に呼び出されます。

• resolve-library-id は一般的なライブラリ名（「supabase」「next.js」）を Context7 互換の ID に変換します。引数は libraryName と、結果の並べ替えに使われる query です。
• query-docs は指定した libraryId と query に対するドキュメントとコード例を返します。任意の language パラメーターを指定すると、その言語のコード例が優先されます。

ライブラリ ID がわかっていればプロンプトに書いておくことで、エージェントは直接 query-docs を呼び出せます。

Context7 MCP Server のユースケース

• 変化の速いフレームワークでのコーディング：「Create a Next.js proxy that checks for a valid JWT in cookies and redirects unauthenticated users to /login. use context7」
• プラットフォームの設定：「Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7」
• 特定の API を調べる：「Show me the Supabase auth API for email/password sign-up.」
• アップグレード中に特定バージョンを指定する。たとえば旧バージョンから移行する際に Next.js 16 の挙動を尋ねる。
• Cursor Rules や CLAUDE.md に「Always use Context7 when I need library/API documentation, code generation, setup or configuration steps」のようなルールを書き、Context7 を自動で使わせる。

Context7 MCP Server と代替ツールの比較

• DeepWiki MCP Server： 自動生成された wiki ページをもとに GitHub リポジトリに関する質問に答えます。Context7 はコーディング用プロンプト向けに、整理されたバージョン別のライブラリドキュメントとコードスニペットに特化しています。
• エージェント組み込みの Web 検索： 汎用的ですが構造化されていません。Context7 は特定のライブラリとバージョン向けにパース済みのドキュメントを返すため、トークン消費や回り道が少なくなりがちです。
• リモート版とローカル版の Context7： リモート URL ならローカルに Node.js は不要です。ローカルの @upstash/context7-mcp パッケージも Context7 API を呼び出すため、どちらの場合もネットワーク接続が必要です。

Context7 MCP Server のトラブルシューティング

• レート制限にかかる： context7.com/dashboard で API キーを作成し、Authorization: Bearer（リモート）または --api-key（ローカル）で送ってください。
• 401 Unauthorized： キーが正しく ctx7sk で始まっているか、トランスポートに合ったヘッダーまたはフラグを使っているかを確認します。
• ライブラリが 404 になる： ID は /owner/repo または /owner/repo/version の形式である必要があります。まず resolve-library-id を実行し、そのライブラリが context7.com に存在するか確認してください。
• ローカルサーバーが起動しない： node --version で Node.js が新しいか確認し、@upstash/context7-mcp@latest を試すか、ERR_MODULE_NOT_FOUND の場合は npx の代わりに bunx を使います。リモート URL に切り替えれば Node.js の問題は避けられます。
• Claude Code で認識されない： claude mcp list でサーバーを確認し、claude mcp logs context7 を見るか、削除して追加し直します。接続は curl https://mcp.context7.com/ping でテストできます。