Context7 MCP：AIコーディングアシスタントに常に最新のドキュメントを提供

AIコーディングアシスタントを使用する際、以下のような問題に遭遇したことはありませんか？

• 古いAPI：AIが非推奨のメソッドを使用したコードを生成する
• 存在しない関数：AIが存在しないAPIを「幻覚」する
• バージョン不一致：サンプルコードが古いバージョン用で、現在のバージョンでは動作しない
• 頻繁なドキュメント参照：エディタとブラウザを何度も切り替える

Context7 MCPは、これらの課題を解決するために作られたツールです。Upstashが開発したModel Context Protocolサーバーで、バージョン固有の公式ドキュメントをリアルタイムで提供し、AIのプロンプトに直接注入します。

Context7 MCPとは？

Context7は、LLMとAIコーディングアシスタントにリアルタイム、正確、バージョン固有のコードドキュメントを提供するMCPサーバーです。

主要機能

1. リアルタイムドキュメントアクセス 📚

   • 公式ソースから直接最新ドキュメントを取得
   • AIが常に最新の情報を使用することを保証

2. バージョン固有の精度 🎯

   • 正確なバージョン番号をサポート（例：react@18.2.0）
   • バージョン不一致によるコードエラーを回避

3. ゼロスイッチワークフロー ⚡

   • ドキュメントをプロンプトに直接注入、ブラウザジャンプ不要
   • 生産性を向上させ、集中力を維持

4. 幅広い互換性 🔌

   • すべてのMCP互換エディタで動作
   • Claude Desktop、Cursor、Windsurfなど

仕組み

Context7は2つの主要なツールを提供します：

1. resolve-library-id

パッケージ名をContext7互換のライブラリIDに解決します。

// ユーザー入力：「Reactを使いたい」
→ resolve-library-id("react")
→ 返答: [
    { id: "/react/react", name: "React", version: "latest" },
    { id: "/react/react/18.2.0", name: "React", version: "18.2.0" },
    { id: "/react/react/19.0.0", name: "React", version: "19.0.0" }
  ]

2. get-library-docs

指定されたライブラリの最新ドキュメントを取得します。

// React 18.2.0のドキュメントを取得
→ get-library-docs("/react/react/18.2.0", maxTokens: 5000)
→ 返答：公式ドキュメントコンテンツ（React Hooks、Component APIなど）

主要機能：

• maxTokensパラメータ：ドキュメントの長さを制御（デフォルト5000）
• 高い値はより多くのコンテキストを提供しますが、より多くのトークンを消費します

インストールとセットアップ

方法1：公式CLI（推奨）

# プロジェクトスコープにインストール
claude mcp add \
  --scope project \
  context7 \
  -e CONTEXT7_API_KEY=<your-api-key> \
  -- npx -y @upstash/context7-mcp

# グローバルにインストール
claude mcp add \
  --scope global \
  context7 \
  -e CONTEXT7_API_KEY=<your-api-key> \
  -- npx -y @upstash/context7-mcp

方法2：手動設定

.claude/config.json（プロジェクト）または~/.claude/config.json（グローバル）を編集：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<your-api-key>"
      }
    }
  }
}

APIキーの取得

1. context7.com/dashboardにアクセス
2. サインアップしてAPIキーを作成
3. 環境変数にキーを設定

実際の使用例

例1：最新のNext.js App Routerの使用法を照会

あなた：「Next.js 14のApp Routerを使って動的ルートを作成してください」

Context7が自動実行：
1. resolve-library-id("nextjs") → /vercel/next.js/14.0.0
2. get-library-docs("/vercel/next.js/14.0.0") → App Routerドキュメントを取得

AIの応答：Next.js 14の公式ドキュメントによると、正しいアプローチは...

例2：バージョン固有のAPIを使用

あなた：「React 18.2を使用しています。useTransitionでこのフォームを最適化してください」

Context7が自動実行：
1. resolve-library-id("react@18.2") → /react/react/18.2.0
2. get-library-docs("/react/react/18.2.0") → React 18.2 Hooksドキュメントを取得

AIの応答：React 18.2のuseTransition APIによると...

料金プラン（2026年1月更新）

プラン	価格	リクエスト数	適している人
Free	$0/月	500リクエスト/月	個人試用
Pro	$10/月	無制限	プロフェッショナル開発者

⚠️ 注意：2026年1月、Context7は無料プランを大幅に調整し、無制限から月間500リクエストに削減しました（92%削減）。ヘビーユーザーの場合、Proへのアップグレードをお勧めします。

なぜContext7が必要か？

問題：AIの「知識カットオフ日」

大規模言語モデルはカットオフ日のあるデータでトレーニングされています。Claude Sonnet 4.5の知識が2025年1月まで更新されていても：

• 新しいフレームワークバージョン（Next.js 15など）がカットオフ後にリリース
• APIの詳細変更（パラメータ名、戻り値形式）
• 新機能のベストプラクティス（React Server Componentsの進化など）

これらの変更により、AIは不正確または古いコードを生成します。

解決策：リアルタイムドキュメント注入

Context7はMCPプロトコルを使用して、最新の公式ドキュメントをAIのコンテキストに直接注入し、すべてのコード生成が最新の正確な情報に基づいていることを保証します。

Context7 vs. 手動ドキュメント検索

比較項目	手動検索	Context7 MCP
切り替えコスト	ブラウザジャンプが必要	ゼロスイッチ
バージョン管理	手動でバージョン確認	自動バージョンマッチング
統合	コピー&ペーストが必要	プロンプトに自動注入
効率	ワークフローを中断	シームレスな統合
精度	AIの記憶に依存	公式ドキュメントを直接使用

高度な使用テクニック

1. バージョンを明示的に指定

「Tailwind CSS 3.4の新しいcontainer query機能を使用してレスポンシブレイアウトを実装」

Context7は自動的に3.4を解析し、そのバージョンのドキュメントを取得します。

2. ドキュメントの長さを制御

プロジェクトの.claude/config.jsonでmaxTokensを調整：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "CONTEXT7_API_KEY": "<your-api-key>",
        "CONTEXT7_MAX_TOKENS": "10000"  // 10000に増やす
      }
    }
  }
}

3. 他のMCPサーバーと組み合わせる

Context7は他のMCPサーバーと相乗的に動作します：

• Memory MCP：プロジェクトのパッケージバージョンを記憶
• Filesystem MCP：package.jsonを読み取ってバージョンを自動推測
• Sequential Thinking MCP：複雑な問題を分解

サポートされている言語とフレームワーク

Context7は数千の人気パッケージとフレームワークをサポートしています：

フロントエンド

• React、Vue、Angular、Svelte
• Next.js、Nuxt、SvelteKit
• Tailwind CSS、Bootstrap

バックエンド

• Node.js、Express、NestJS
• Python（Flask、Django、FastAPI）
• Go、Rust

データベース & インフラストラクチャ

• PostgreSQL、MongoDB、Redis
• AWS SDK、Google Cloud SDK
• Kubernetes、Docker

完全なリストはContext7公式サイトで確認できます。

ベストプラクティス

✅ 推奨

1. プロジェクトレベルのインストール：--scope projectを使用してグローバル汚染を回避
2. バージョンロック：プロンプトでバージョン番号を明示的に指定
3. 適切なトークン使用：一般的なクエリには5000、複雑なAPIには10000+
4. Memory MCPと組み合わせる：Claudeにプロジェクトパッケージを記憶させる

❌ 避けるべき

1. 過度の依存：基本的な構文にはドキュメントは不要
2. 無制限のトークン：クォータを消費し、応答遅延を増加させる
3. 混合バージョン：プロジェクトの依存関係がドキュメントバージョンと一致することを確認

トラブルシューティング

問題1：Context7に接続できない

# APIキーが正しいか確認
echo $CONTEXT7_API_KEY

# 接続テスト
npx @upstash/context7-mcp

問題2：パッケージが見つからない

あなた：「some-obscure-libraryを使いたい」
Context7：一致するライブラリが見つかりません

解決方法：

• パッケージ名のスペルを確認
• 完全なnpmパッケージ名を使用してみる（例：@org/package）
• Context7サポートリストを確認

問題3：ドキュメントが古すぎる

ドキュメントが最新でない場合：

1. Context7チームに報告（GitHub Issues）
2. 手動で新しいバージョン番号を指定
3. Web Searchで最新情報を補完

Context7の未来

OAuth 2.0サポート

Context7はOAuth 2.0認証をサポートしており、MCP OAuth準拠のクライアントにより安全な資格情報管理を提供します：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "oauth": {
        "endpoint": "https://context7.com/mcp/oauth"
      }
    }
  }
}

MCPエコシステム

Context7はModel Context Protocolエコシステムのスタープロジェクトの1つです。2025年12月、AnthropicはAgentic AI Foundation（Anthropic、Block、OpenAIが共同創設）にMCPを寄贈し、MCPが業界標準となったことを示しています。

2025年3月、OpenAIは公式にMCPを採用し、ChatGPTデスクトップアプリに統合し、MCPの普及をさらに推進しました。

Context7は2025年11月にThoughtworks Technology RadarでTrial段階としてリストされ、試用に値する成熟したツールとして業界で認められました。

結論

Context7 MCPは、AIコーディングアシスタントの核心的な課題である古い知識と不正確なコード生成を解決します。バージョン固有の公式ドキュメントをリアルタイムで提供することで、Claude、Cursor、Windsurfなどのツールがより正確で信頼性の高いコードを生成できるようにします。

あなたに適していますか？

使用シナリオ	推奨度
新しいフレームワークの学習	⭐⭐⭐⭐⭐
頻繁な技術スタックの切り替え	⭐⭐⭐⭐⭐
最新バージョンのフレームワーク使用	⭐⭐⭐⭐⭐
日常的な開発支援	⭐⭐⭐⭐
基本的な構文検索	⭐⭐

今すぐ始める

1. context7.comでサインアップ
2. APIキーを取得
3. claude mcp addを使用してインストール
4. ゼロスイッチの開発体験を楽しむ

参考資料

• Context7公式ウェブサイト
• Context7 GitHubリポジトリ
• Model Context Protocol仕様
• Upstash公式ブログ
• Context7 MCPのインストールと使用方法
• Smithery.aiのContext7