yujunjun/context7
1
0
Fork 0
mirror of https://github.com/upstash/context7.git synced 2025-11-30 00:50:06 +00:00
Code Issues Packages Projects Releases Wiki Activity
context7/docs/README.ja.md
Kc 7b46212f93 Add Copilot CLI installation instructions to docs 
Added detailed instructions for installing and configuring Context7 MCP in Copilot CLI to all localized README files. This includes example JSON configurations for both remote and local MCP servers, and notes on creating the configuration file if it does not exist.
2025-11-03 13:27:49 +08:00

26 KiB
Raw Blame History

Context7 MCP - どんなプロンプトにも最新のコードドキュメントで応える

Website smithery badge Install in VS Code (npx)

繁體中文 簡體中文 日本語 한국어 문서 Documentación en Español Documentation en Français Documentação em Português (Brasil) Documentazione in italiano Dokumentasi Bahasa Indonesia Dokumentation auf Deutsch Документация на русском языке Türkçe Doküman Arabic Documentation

❌ Context7 を使わないと

LLM は使用しているライブラリに関する古い情報や一般的な情報に依存しています。その結果：

  • ❌ コード例が古く、1 年前のトレーニングデータに基づいている
  • ❌ 存在しない API をハルシネーションして生成する
  • ❌ 古いパッケージバージョンに対する一般的な回答しか得られない

✅ Context7 を使うと

Context7 MCP は最新のバージョン固有のドキュメントとコード例をソースから直接取得し、プロンプトに直接配置します。

Cursor のプロンプトに use context7 を追加するだけ：

Create a basic Next.js project with app router. use context7

Create a script to delete the rows where the city is "" given PostgreSQL credentials. use context7

Context7 は最新のコード例とドキュメントを直接 LLM のコンテキストに取得します。

  • 1️⃣ 普段通りにプロンプトを書く
  • 2️⃣ LLM に use context7 と指示する
  • 3️⃣ 動作するコードの回答を得る

タブの切り替えも、存在しない API のハルシネーションも、古いコード生成もありません。

📚 プロジェクトの追加

プロジェクト追加ガイド をチェックして、お気に入りのライブラリを Context7 に追加（または更新）する方法を学びましょう。

🛠️ インストール

必須要件

  • Node.js >= v18.0.0
  • Cursor、Windsurf、Claude Desktop またはその他の MCP クライアント
Smithery 経由でのインストール

Smithery 経由で任意のクライアントに Context7 MCP サーバーを自動的にインストールするには：

npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Smithery キーは Smithery.ai Web ページ で確認できます。

Cursor へのインストール

Settings -> Cursor Settings -> MCP -> Add new global MCP server に移動します

以下の設定を Cursor の ~/.cursor/mcp.json ファイルに貼り付けることが推奨されます。プロジェクトフォルダに .cursor/mcp.json を作成することで、特定のプロジェクトにインストールすることもできます。詳細は Cursor MCP ドキュメント を参照してください。

Cursor 1.0 以降、下のインストールボタンをクリックすることで、ワンクリックで即座にインストールできます。

Cursor リモートサーバー接続

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Cursor ローカルサーバー接続

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
代替方法：Bun を使用

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
代替方法：Deno を使用

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}
Windsurf へのインストール

これを Windsurf MCP 設定ファイルに追加します。詳細は Windsurf MCP ドキュメント を参照してください。

Windsurf リモートサーバー接続

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp"
    }
  }
}

Windsurf ローカルサーバー接続

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
VS Code へのインストール

Install in VS Code (npx) Install in VS Code Insiders (npx)

これを VS Code MCP 設定ファイルに追加します。詳細は VS Code MCP ドキュメント を参照してください。

VS Code リモートサーバー接続

"mcp": {
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

VS Code ローカルサーバー接続

"mcp": {
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Cline でのインストール
  1. Cline を開きます。
  2. メニューアイコン (☰) をクリックし、MCP サーバーセクションに移動します。
  3. リモートサーバー タブを選択します。
  4. 設定を編集 ボタンをクリックします。
  5. context7 に関連する設定を mcpServers に追加します：
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Visual Studio 2022 へのインストール

Visual Studio MCP サーバードキュメント に従って、Visual Studio 2022 で Context7 MCP を設定できます。

これを Visual Studio MCP 設定ファイルに追加します（詳細は Visual Studio ドキュメント を参照）：

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "http",
        "url": "https://mcp.context7.com/mcp"
      }
    }
  }
}

または、ローカルサーバーの場合：

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      }
    }
  }
}

詳細情報とトラブルシューティングについては、Visual Studio MCP サーバードキュメント を参照してください。

Zed へのインストール

Zed Extensions 経由でインストールできるか、Zed の settings.json にこれを追加できます。詳細は Zed Context Server ドキュメント を参照してください。

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      },
      "settings": {}
    }
  }
}
Claude Code へのインストール

このコマンドを実行します。詳細は Claude Code MCP ドキュメント を参照してください。

Claude Code リモートサーバー接続

claude mcp add --transport http context7 https://mcp.context7.com/mcp

Claude Code ローカルサーバー接続

claude mcp add context7 -- npx -y @upstash/context7-mcp
Claude Desktop へのインストール

これを Claude Desktop の claude_desktop_config.json ファイルに追加します。詳細は Claude Desktop MCP ドキュメント を参照してください。

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
BoltAI へのインストール

アプリの "Settings" ページを開き、"Plugins" に移動し、以下の JSON を入力します：

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

保存後、チャットで get-library-docs の後に Context7 ドキュメント ID を入力します（例：get-library-docs /nuxt/ui）。詳細情報は BoltAI ドキュメンテーションサイト で利用可能です。iOS 版 BoltAI については、このガイドを参照してください。

Copilot Coding Agent へのインストール

以下の設定を Copilot Coding Agent の mcp セクション（Repository->Settings->Copilot->Coding agent->MCP configuration）に追加してください：

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "tools": ["get-library-docs", "resolve-library-id"]
    }
  }
}

詳細は 公式 GitHub ドキュメント をご覧ください。

Copilot CLI へのインストール
  1. Copilot CLI MCP 設定ファイルを開きます。ファイルの場所は ~/.copilot/mcp-config.json（~ はホームディレクトリ）です。
  2. mcp-config.json ファイルの mcpServers オブジェクトに以下を追加します：
{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "tools": [
        "get-library-docs", 
        "resolve-library-id"
      ]
    }
  }
}

または、ローカルサーバーの場合：

{
  "mcpServers": {
    "context7": {
      "type": "local",
      "command": "npx",
      "tools": [
        "get-library-docs", 
        "resolve-library-id"
      ],
      "args": [
        "-y",
        "@upstash/context7-mcp",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

mcp-config.json ファイルが存在しない場合は、作成してください。

Docker を使用

MCP サーバーを Docker コンテナで実行したい場合：

  1. Docker イメージのビルド：

    まず、プロジェクトルート（または希望の場所）に Dockerfile を作成します：

    Dockerfile の内容を表示 
    FROM node:18-alpine

WORKDIR /app

# 最新バージョンをグローバルにインストール
RUN npm install -g @upstash/context7-mcp

# 必要に応じてデフォルトポートを公開（任意、MCP クライアントの相互作用に依存）
# EXPOSE 3000

# サーバーを実行するデフォルトコマンド
CMD ["context7-mcp"]

    次に、タグ（例：context7-mcp）を使用してイメージをビルドします。Docker Desktop（または Docker デーモン）が実行中であることを確認してください。 Dockerfile を保存した同じディレクトリで次のコマンドを実行します：

    docker build -t context7-mcp .

  2. MCP クライアントの設定：

    MCP クライアントの設定を更新して Docker コマンドを使用するようにします。

    cline_mcp_settings.json の例：

    {
  "mcpServers": {
    "Сontext7": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}

    注：これは設定例です。この README の前半で MCP クライアント（Cursor、VS Code など）の具体的な例を参照して、構造（例：mcpServers 対 servers）を適応させてください。また、args 内のイメージ名が docker build コマンドで使用したタグと一致していることを確認してください。

Windows へのインストール

Windows での設定は Linux や macOS と比べて少し異なります（例では Cline を使用）。同じ原則が他のエディタにも適用されます。command と args の設定を参照してください。

{
  "mcpServers": {
    "github.com/upstash/context7-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Augment Code へのインストール

Augment Code で Context7 MCP を設定するには、グラフィカルインターフェースまたは手動設定のいずれかを使用できます。

A. Augment Code UI を使用する場合

  1. ハンバーガーメニューをクリックします。

  2. Settings を選択します。

  3. Tools セクションに移動します。

  4. + Add MCP ボタンをクリックします。

  5. 以下のコマンドを入力します：

    npx -y @upstash/context7-mcp@latest

  6. MCP に Context7 と名前を付けます。

  7. Add ボタンをクリックします。

MCP サーバーが追加されたら、Augment Code 内で Context7 の最新コードドキュメンテーション機能を直接使用できます。

B. 手動設定

  1. Cmd/Ctrl Shift P を押すか、Augment パネルのハンバーガーメニューに移動します
  2. Edit Settings を選択します
  3. Advanced の下で、Edit in settings.json をクリックします
  4. augment.advanced オブジェクト内の mcpServers 配列にサーバー設定を追加します

"augment.advanced": { "mcpServers": [ { "name": "context7", "command": "npx", "args": ["-y", "@upstash/context7-mcp"] } ] }

MCP サーバーが追加されたら、エディタを再起動します。エラーが発生した場合は、構文をチェックして、閉じ括弧やカンマが欠けていないことを確認してください。

Roo Code へのインストール

これを Roo Code MCP 設定ファイルに追加します。詳細は Roo Code MCP ドキュメント を参照してください。

Roo Code リモートサーバー接続

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Roo Code ローカルサーバー接続

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Zencoder へのインストール

Zencoder で Context7 MCP を設定するには、以下の手順に従います：

  1. Zencoder メニュー (...) に移動します
  2. ドロップダウンメニューから Agent tools を選択します
  3. Add custom MCP をクリックします
  4. 以下から名前とサーバー設定を追加し、Install ボタンを必ず押してください
{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp@latest"]
}

MCP サーバーが追加されたら、簡単に使用を続けることができます。

Amazon Q Developer CLI へのインストール

これを Amazon Q Developer CLI 設定ファイルに追加します。詳細は Amazon Q Developer CLI ドキュメント を参照してください。

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

🔨 利用可能なツール

Context7 MCP は LLM が使用できる以下のツールを提供します：

  • resolve-library-id：一般的なライブラリ名を Context7 互換のライブラリ ID に変換します。

    • libraryName（必須）：検索するライブラリの名前

  • get-library-docs：Context7 互換のライブラリ ID を使用してライブラリのドキュメントを取得します。

    • context7CompatibleLibraryID（必須）：正確な Context7 互換のライブラリ ID（例：/mongodb/docs、/vercel/next.js）
    • topic（任意）：ドキュメントの特定のトピックに焦点を当てます（例："routing"、"hooks"）
    • tokens（任意、デフォルト 10000）：返すトークンの最大数。デフォルト値 10000 未満の値は自動的に 10000 に増加されます。

💻 開発

プロジェクトをクローンして依存関係をインストールします：

bun i

ビルド：

bun run build

サーバーを実行：

bun run dist/index.js

CLI 引数

context7-mcp は以下の CLI フラグを受け付けます：

  • --transport <stdio|http> – 使用するトランスポート（デフォルトは stdio）。
  • --port <number> – http トランスポート使用時にリッスンするポート（デフォルト 3000）。

http トランスポートとポート 8080 の例：

bun run dist/index.js --transport http --port 8080
ローカル設定例 
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}
MCP Inspector でのテスト 
npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

🚨 トラブルシューティング

モジュールが見つからないエラー

ERR_MODULE_NOT_FOUND が発生した場合は、npx の代わりに bunx を使用してみてください：

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

これにより、npx がパッケージを正しくインストールまたは解決できない環境でのモジュール解決の問題が解決されることがあります。

ESM 解決の問題

Error: Cannot find module 'uriTemplate.js' のようなエラーの場合は、--experimental-vm-modules フラグを試してください：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
    }
  }
}
TLS/証明書の問題

TLS 関連の問題を回避するには、--experimental-fetch フラグを使用します：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
    }
  }
}
一般的な MCP クライアントエラー
  1. パッケージ名に @latest を追加してみる
  2. npx の代替として bunx を使用する
  3. 別の代替方法として deno の使用を検討する
  4. ネイティブ fetch サポートのために Node.js v18 以上を使用していることを確認する

⚠️ 免責事項

Context7 プロジェクトはコミュニティが貢献しているもので、高品質を維持するよう努めていますが、すべてのライブラリドキュメントの正確性、完全性、セキュリティを保証することはできません。Context7 にリストされているプロジェクトは、Context7 ではなく、それぞれの所有者によって開発および保守されています。疑わしい、不適切な、または潜在的に有害なコンテンツを発見した場合は、プロジェクトページの「報告」ボタンを使用して、すぐにお知らせください。私たちはすべての報告を真剣に受け止め、プラットフォームの整合性と安全性を維持するために、フラグが付けられたコンテンツを迅速にレビューします。Context7 を使用することにより、あなたは自己の裁量とリスクで使用することを認めます。

🤝 私たちとつながる

最新情報を入手し、コミュニティに参加しましょう：

  • 📢 最新ニュースとアップデートのために X でフォローしてください
  • 🌐 Web サイト を訪問してください
  • 💬 Discord コミュニティ に参加してください

📺 メディアでの Context7

⭐ スター履歴

Star History Chart

📄 ライセンス

MIT