MCPサーバ - Context7のソースを表示

== 概要 ==
Context7 MCP Server (@upstash/context7-mcp) は、Upstashが開発したMCPサーバである。<br>
LLMのコンテキストウィンドウに最新のバージョン固有のライブラリドキュメントとコード例を直接注入することで、ハルシネーションを排除し、正確なコード生成を実現する。<br>
<br>
LLMは学習データに基づいて回答するため、古いバージョンのAPIを使用したコードを生成したり、存在しない関数やメソッドを生成することがある。<br>
Context7はこの問題を解決するために、プロンプトに <code>use context7</code> と追記するだけで、対象ライブラリの最新ドキュメントを自動的に取得してコンテキストに統合する。<br>
<br>
主な特徴は以下の通りである。<br>
* 最新バージョン固有のドキュメントをリアルタイムで取得
* Next.js、React、Vue.js、TypeScript等、数千のライブラリに対応
* プロンプトへの <code>use context7</code> 追記だけで動作する簡単な操作性
* Claude Desktop、Claude Code、Cursor、VS Code、Windsurf等の主要MCPクライアントに対応
* Windows、MacOS、Linuxに対応
<br><br>

== 動作要件 ==
==== 前提条件 ====
Context7 MCP Serverを使用するために必要な前提条件を以下に示す。<br>
<br>
* Node.js v18以上
*: <code>npx</code> コマンドを使用してContext7 MCP Serverを実行するために必要
* インターネット接続
*: ライブラリドキュメントをContext7サーバから取得するために必要
<br><br>

== インストール ==
==== 簡単セットアップ ====
<code>ctx7</code> CLIを使用して、MCPクライアントへの設定を自動的に行うことができる。<br>
<br>
全クライアントを対象にセットアップする場合は、以下のコマンドを実行する。<br>
<br>
 npx ctx7 setup
<br>
特定のMCPクライアントのみを対象にセットアップする場合は、以下に示すコマンドを実行する。<br>
<br>
Claude Desktop向けのセットアップコマンドを以下に示す。<br>
<br>
 npx ctx7 setup --claude
<br>
Cursor向けのセットアップコマンドを以下に示す。<br>
<br>
 npx ctx7 setup --cursor
<br>
VS Code向けのセットアップコマンドを以下に示す。<br>
<br>
 npx ctx7 setup --code
<br>
==== Smithery経由のインストール ====
Smitheryを使用してContext7 MCP Serverをインストールする場合は、以下に示すコマンドを実行する。<br>
<br>
 npx -y @smithery/cli install @upstash/context7-mcp --client claude
<br><br>

== 設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。<br>
<br>
Claude Desktopの設定ファイルを以下に示す。<br>
* Linux
*: <u>~/.config/Claude/claude_desktop_config.json</u>
* MacOS
*: <u>~/Library/Application Support/Claude/claude_desktop_config.json</u>
* Windows
*: <u>%APPDATA%\Claude\claude_desktop_config.json</u>
<br>
Claude Codeの設定ファイルを以下に示す。<br>
* ローカルスコープ
*: <u>.mcp.json</u> (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: <u>~/.claude.json</u> (ホームディレクトリ)
<br>
Cursorの設定ファイルを以下に示す。<br>
* グローバル設定
*: <u>~/.cursor/mcp.json</u>
* プロジェクト設定
*: <u>.cursor/mcp.json</u>
<br>
VS Codeの設定ファイルを以下に示す。<br>
* <u>.vscode/mcp.json</u> (プロジェクトルート)
<br>
==== Claude Desktopの設定 ====
<u>claude_desktop_config.json</u> ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
 </syntaxhighlight>
<br>
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。<br>
<br>
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してContext7 MCP Serverを追加できる。<br>
<br>
以下のコマンドでMCPサーバをClaude Codeに登録する。<br>
<br>
 claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
<br>
==== Cursorの設定 ====
<u>~/.cursor/mcp.json</u> または <u>.cursor/mcp.json</u> ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== VS Codeの設定 ====
<u>.vscode/mcp.json</u> ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp@latest"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== APIキーを使用した設定 ====
APIキーを使用する場合は、設定ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
     }
   }
 }
 </syntaxhighlight>
<br>
APIキーは、[https://context7.com/dashboard Context7ダッシュボード]から取得できる。<br>
<u>APIキーは作成時のみ表示されるため、作成後は安全な場所に保管すること。</u><br>
<br><br>

== 環境変数とオプション ==
==== 環境変数一覧 ====
下表に、Context7 MCP Serverの動作をカスタマイズするための環境変数を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 説明
|-
| <code>DEFAULT_MINIMUM_TOKENS</code> || ドキュメント取得時のトークン数の最小値を指定する。<br>デフォルト値は <u>10000</u> である。
|-
| <code>CONTEXT7_API_KEY</code> || Context7 APIの認証用キーを指定する。<br>[https://context7.com/dashboard Context7ダッシュボード]から取得できる。<br>CLIフラグ <code>--api-key</code> おオプションでも指定可能
|}
</center>
<br>
環境変数を設定ファイルに記述する場合の例を以下に示す。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "context7": {
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp@latest"],
       "env": {
         "DEFAULT_MINIMUM_TOKENS": "20000",
         "CONTEXT7_API_KEY": "YOUR_API_KEY"
       }
     }
   }
 }
 </syntaxhighlight>
<br><br>

== 提供ツール ==
Context7 MCP Serverは、ライブラリドキュメントを取得するための2つのツールを提供する。<br>
<br>
==== ツール一覧 ====
下表に、Context7 MCP Serverが提供するツールを示す。<br>
<br>
<center>
{| class="wikitable"
|+ ツール一覧
! ツール名 !! 説明
|-
| <code>resolve-library-id</code> || ライブラリの一般名をContext7互換のライブラリIDに変換する。<br>例: "next.js" --> "/vercel/next.js"
|-
| <code>query-docs</code> || ライブラリIDを使用してドキュメントを取得する。<br>パラメータ: <code>libraryId</code>、<code>query</code><br>トークン制限: デフォルト 5000〜10000
|}
</center>
<br><br>

== 使用方法 ==
Context7 MCP Serverを設定後、プロンプトに <code>use context7</code> と追記するだけで、<br>
AIアシスタントが自動的にContext7ツールを呼び出し、最新のドキュメントをコンテキストに統合する。<br>
<br>
==== 基本的な使用例 ====
基本的なプロンプトの書き方を以下に示す。<br>
<br>
* Next.js 14でルーティングとサーバコンポーネントを使用する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 Create a Next.js 14 project with routing and server components. use context7
 </syntaxhighlight>
*: <br>
* zodのスキーマ定義でバリデーションを行う場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 zod v4のスキーマ定義で文字列かつ最低5文字以上という制約を持たせたい。use context7
 </syntaxhighlight>
*: <br>
<br>
==== ライブラリIDを指定した使用例 ====
ライブラリIDを直接指定することにより、曖昧さなく対象ライブラリのドキュメントを取得できる。<br>
<br>
* Supabaseのライブラリを指定する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 use library /supabase/supabase for API and docs.
 </syntaxhighlight>
*: <br>
<br>
==== 複数ライブラリを指定した使用例 ====
複数のライブラリを同時に指定することもできる。<br>
<br>
* MongoDBとExpress.jsを組み合わせてREST APIを構築する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 Create a REST API using MongoDB and Express.js with JWT authentication. use context7
 </syntaxhighlight>
*: <br>
<br>
==== 対応ライブラリ ====
Context7が対応している主なライブラリを以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ 技術スタック一覧
|-
! カテゴリ !! 技術
|-
| フロントエンド || Next.js、React、Vue.js、Astro
|-
| バックエンド || Node.js、Express.js、Django、FastAPI
|-
| データベース || MongoDB、Supabase、PostgreSQL
|-
| バリデーション || Zod
|-
| 言語 || TypeScript
|}
</center>
<br>
その他、数千のライブラリに対応している。<br>
詳細を知りたい場合は、[https://context7.com context7.com]を参照すること。<br>
<br><br>

== トラブルシューティング ==
==== 一般的な問題 ====
下表に、一般的なエラーと対処法を示す。<br>
<br>
<center>
{| class="wikitable"
|+ トラブルシューティング一覧
! 問題 !! 対処法
|-
| <code>ERR_MODULE_NOT_FOUND</code> エラーが発生する || <code>npx</code> の代わりに <code>bunx</code> または <code>deno</code> を使用する。<br><code>@latest</code> サフィックスを削除して試す。
|-
| <code>Cannot find module</code> エラーが発生する || Node.js v18以上がインストールされているか確認する。
|-
| APIキーエラー (403) が発生する || [https://context7.com/dashboard Context7ダッシュボード]で新しいAPIキーを生成する。<br>APIキーは作成時のみ表示されるため、再生成が必要な場合がある。
|-
| ドキュメントの取得に失敗する || <code>resolve-library-id</code> ツールでライブラリIDを確認する。<br>[https://context7.com context7.com] でライブラリが対応しているか確認する。
|-
| 接続問題が発生する || Node.jsのバージョンを確認する。<br><code>npm cache clean --force</code> コマンドでnpmキャッシュをクリアする。
|}
</center>
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Context7,MCP,Model Context Protocol,context7-mcp,Claude,Claude Code,Claude Desktop,Cursor,VS Code,Windsurf,Upstash,Node.js,npx,ドキュメント,ハルシネーション,Next.js,React,TypeScript,AIアシスタント,MCPサーバ
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]