yujunjun/context7

Fork 0

mirror of https://github.com/upstash/context7.git synced 2025-06-26 23:50:04 +00:00

jnst a47a3026f3 docs: Add Japanese translation

2025-06-18 16:59:39 +09:00

23 KiB

Raw Blame History

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

❌ 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 リモートサーバー接続

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

Cursor ローカルサーバー接続

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

代替方法：Bun を使用

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

代替方法：Deno を使用

{
  "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/sse"
    }
  }
}

Windsurf ローカルサーバー接続

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

VS Code へのインストール

これを 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"]
    }
  }
}

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 sse context7 https://mcp.context7.com/sse

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 については、このガイドを参照してください。

Docker を使用

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

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 .
```
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 を使用する場合

ハンバーガーメニューをクリックします。
Settings を選択します。
Tools セクションに移動します。
+ Add MCP ボタンをクリックします。
以下のコマンドを入力します：
```
npx -y @upstash/context7-mcp@latest
```
MCP に Context7 と名前を付けます。
Add ボタンをクリックします。

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

B. 手動設定

Cmd/Ctrl Shift P を押すか、Augment パネルのハンバーガーメニューに移動します
Edit Settings を選択します
Advanced の下で、Edit in settings.json をクリックします
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 を設定するには、以下の手順に従います：

Zencoder メニュー (...) に移動します
ドロップダウンメニューから Agent tools を選択します
Add custom MCP をクリックします
以下から名前とサーバー設定を追加し、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|sse> – 使用するトランスポート（デフォルトは stdio）。
--port <number> – http または sse トランスポート使用時にリッスンするポート（デフォルト 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 クライアントエラー

パッケージ名に @latest を追加してみる
npx の代替として bunx を使用する
別の代替方法として deno の使用を検討する
ネイティブ fetch サポートのために Node.js v18 以上を使用していることを確認する

⚠️ 免責事項

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

🤝 私たちとつながる

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

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

📺 メディアでの Context7

⭐ スター履歴

📄 ライセンス

MIT

23 KiB Raw Blame History Unescape Escape