Context7 MCP

問題: モデルのトレーニングデータにはカットオフ日があります。React 19、Next.js 15、または過去数ヶ月にメジャーリリースがあったライブラリについて質問すると、回答が間違っていることがあります。古いパターン、存在しないAPI、2バージョン前にリネームされた関数。

すぐに試せること: MCPの設定にContext7を追加し、任意のプロンプトに use context7 と付け加えるだけです。コードが書かれる前にドキュメントが取得されます。

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

Context7 MCPとは何か

簡単に説明します。Context7はMCPサーバーです。その役割は1つ、ライブラリ自身のソースから最新のバージョン固定されたドキュメントとサンプルを直接取得すること。数ヶ月前の重みファイルからではありません。

仕組みはシンプルです。公式ドキュメントはライブラリIDとしてインデックスされます。プロンプトでライブラリ名を指定すると、サーバーがその名前を解決し、該当するセクションを取得し、モデルが応答する前にその内容を会話に挿入します。

Claude Codeにとって重要な理由

ハルシネーションされたAPIが核心的な問題です。モデルは、リネームされた、非推奨になった、あるいは最初から存在しなかった関数を提案することがあります。原因は常に同じです。トレーニングデータが実際のリリースタイムラインより遅れているのです。

このサーバーを読み込むことで得られるもの:

• クエリ時のドキュメント取得: 重みファイルに含まれていたものではなく
• バージョン一致したサンプル: プロンプトで指定したリリースに対応
• 動作するパターン: 初回から正しくコンパイルされる公式ドキュメントから引用
• ハルシネーションの減少: 実際のAPIが架空のものに取って代わる

Next.js 15のApp Routerパターンを要求すると、Context7がNext.js 15のドキュメントをその場で取得します。返ってくるコードは、トレーニングセットでNext.js 13が最新だった時代のものではなく、今日存在するAPIを参照しています。

インストールと設定

Node.js 18以降が必要です。パッケージは @upstash/context7-mcp です。

Claude Code CLI

通常は1つのコマンドで完了します。

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

または、プロジェクトルートの .mcp.json に直接記述することもできます。

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

Claude Desktop

macOSユーザーは ~/Library/Application Support/Claude/claude_desktop_config.json を編集してください。

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

Windowsでの対応ファイルは %APPDATA%\Claude\claude_desktop_config.json にあります。

代替手段: Bunランタイム

Bunをお使いの場合はコマンドを変更してください。

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

設定が完了したらClaude Codeを再起動してください。

実際の使い方

サーバーには2つのツールが付属しています。

resolve-library-id: 普通のライブラリ名をContext7互換の識別子にマッピングします。ライブラリが名前で登場するたびにClaudeが活用します。

query-docs: 1つのライブラリの実際のドキュメントを取得します。返ってくるのは最新のドキュメント、サンプル、APIリファレンスです。

基本的な使い方

最新のドキュメントが必要なプロンプトに use context7 を付け加えてください。

Create a Next.js 15 middleware that handles authentication. use context7

3つのことが起こります。

1. 「Next.js」という名前がライブラリID /vercel/next.js に解決される
2. クエリによってMiddlewareのドキュメントが返ってくる
3. 現在のAPIの形に沿ってコードが書かれる

バージョン指定のクエリ

プロンプトにバージョン番号を入れると自動的に認識されます。

How do I configure Prisma 6 with PostgreSQL? use context7

返されるドキュメントは指定した正確なリリースに対応します。

よく使うライブラリID

IDの形式は /organization/repository です。よく使う8つを紹介します。

IDを直接渡すことで名前解決を省略することもできます。

use library /supabase/supabase for API and docs

対応ライブラリ

インデックスには数千のライブラリが登録されています。主なカテゴリ:

フロントエンド: React、Vue、Svelte、Angular、Solid、Qwik

メタフレームワーク: Next.js、Nuxt、SvelteKit、Astro、Remix

バックエンド: Express、Fastify、Hono、NestJS、Koa

データベース: Prisma、Drizzle、Mongoose、TypeORM、Supabase

ユーティリティ: Zod、tRPC、React Query、SWR、Zustand、Jotai

テスト: Vitest、Jest、Playwright、Cypress

公開ドキュメントがあるライブラリはほぼすべてカバーされています。新バージョンはローリングベースで取り込まれます。

MCPツール検索との組み合わせ

MCPツール検索はこのサーバーと相性よく動作します。有効にすると、会話に必要なときだけツールが読み込まれるため、セッションの起動が軽くなります。

重要な理由: コンテキスト制限を超えることなく、他のMCPサーバーと並べてスタックできます。

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

サーバーはプロンプトでドキュメントの話題が出たとき、またはトリガーフレーズが現れたときだけ起動します。アイドル時のトークン消費はゼロです。

トラブルシューティング

ERR_MODULE_NOT_FOUND: npx を bunx に変更してください。環境によってはnpmのキャッシュレイヤーで問題が起きることがあります。

ライブラリが見つからない: すべてのパッケージがインデックスされているわけではありません。名前を解決できない場合、サーバーが明確に通知します。代替としてウェブ検索MCPを使用してください。

古い結果が返ってくる: インデックスはスケジュールで更新されます。数日以内のリリースはまだ反映されていない場合があります。最先端の機能については、公式ドキュメントを直接参照してください。

次のステップ

このようなサーバーは、Claude Codeを固定されたスナップショットから積極的にリサーチするものへと変えます。より充実した設定のために他のサーバーと組み合わせましょう。

• プロトコルがまだ新しい場合はMCPの基本を読む
• 50以上のMCPサーバーのカタログで追加機能を探す
• ライブラリ以外のリサーチ用にウェブ検索MCPを追加する
• コンテキスト使用量を抑えるためにMCPツール検索を有効にする

Context7を接続すれば、非推奨のパターンが消えていきます。use context7 は、コード品質の違いを初めて実感した瞬間から反射的に使うようになります。