Context7 MCP Server (

Context7 MCP サーバー（c7-mcp-server）

Model Context Protocol（MCP）サーバーです。Context7 APIへのブリッジとして機能します。

このサーバーを使うと、MCP 対応クライアント（Claude Desktop、IDE プラグイン、カスタムアプリケーションなど）から、ドキュメントのコンテキストの照会、プロジェクトの検索、プロジェクトのメタデータの取得など、Context7 の機能を簡単に利用できます。グローバルにインストールすると、c7-mcp-server コマンドが使えるようになります。

⚠️ 重要： このサーバーを通じて提供されるデータは、すべて公式の Context7 API（https://context7.com）から直接取得されます。このサーバーは API への MCP インターフェースを提供するだけであり、コンテンツを生成したりホストしたりすることはありません。

機能

標準の MCP 機能を通じて Context7 の機能を公開します。

• ツール：
  • c7_query：プロジェクト内の特定のトピックについて Context7 API に問い合わせます。プロジェクト名とクエリテキストを受け取り、形式（txt/json）とトークン数の上限は任意で指定できます。
  • c7_search：キーワードで利用可能な Context7 プロジェクトを検索します。一致したプロジェクトの一覧（タイトルと利用可能な名前）を返します。
  • c7_info：特定の Context7 プロジェクトのメタデータ（ソースリポジトリ、最終更新日時など）を取得します。
• リソース：
  • c7_projects_list：URI context7://projects/list を通じて、利用可能な（有効な）Context7 プロジェクトの一覧を提供します。

インストール

前提条件

• Node.js（バージョン 18 以降を推奨）
• npm（通常は Node.js に付属）または Bun

オプション 1：npm からインストール（ユーザーにおすすめ）

公開後、サーバーをグローバルにインストールします。

npm install -g c7-mcp-server

これにより、c7-mcp-server コマンドがシステム全体で使えるようになり、MCP クライアントから起動できるようになります。

オプション 2：ソースからインストール（開発用）

1. リポジトリをクローンします。

   git clone <your-repo-url>
   cd c7-mcp-server
   

2. 依存関係をインストールします。

   npm install
   # or if using Bun
   # bun install
   

3. サーバーをビルドします。

   npm run build
   

4. コマンドをローカルにリンクします。

   npm link
   # or if using Bun
   # bun link
   

これにより、テストや開発用にローカルマシンで c7-mcp-server コマンドが使えるようになります。

使用方法

このサーバーは、通常、エンドユーザーが直接実行するのではなく（テストの場合を除く）、MCP クライアントアプリケーションから実行するように設計されています。クライアントが c7-mcp-server コマンドを起動し、MCP プロトコルを使って標準入力／標準出力（stdio）経由で通信します。

クライアントでの設定（例：Claude Desktop）

Claude Desktop のようなクライアントでこのサーバーを使うには、クライアントの設定ファイルに追加する必要があります。

1. c7-mcp-server がグローバルにインストールされている（npm install -g c7-mcp-server）か、ローカルにリンクされている（npm link）ことを確認します。

2. クライアントの設定ファイル（例：claude_desktop_config.json）を編集します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. mcpServers の下にエントリを追加します。

   {
     "mcpServers": {
       "context7": {
         "command": "c7-mcp-server", // The command name installed/linked
         "args": [] // No arguments needed by default for stdio transport
         // "env": {} // Add environment variables if needed
       }
       // ... other servers ...
     }
   }
   

4. クライアントアプリケーション（例：Claude Desktop）を再起動します。クライアントがバックグラウンドで c7-mcp-server を起動し、接続するようになります。

MCP Inspector を使用したテスト

MCP Inspector を使用して、サーバーを直接テストできます。

1. c7-mcp-server がグローバルにインストールされているか、ローカルでリンクされていることを確認します。

2. サーバーコマンドを実行するよう指定して、Inspector を起動します。

   npx @modelcontextprotocol/inspector c7-mcp-server
   

3. ブラウザーで Inspector UI が開き、サーバーに接続します。「Tools」タブと「Resources」タブを使用して、サーバーの機能を操作します。「Notifications」ペインで、サーバーからのログやエラーを確認します。

MCP の機能の詳細

ツール

• c7_query

  • 説明： プロジェクト内の特定のトピックについて、Context7 API に問い合わせます。
  • パラメーター（object）：
    • projectname（string、必須）：正確なプロジェクト名（例：nextjs）。
    • query（string、必須）：問い合わせるトピック／質問。
    • format（enum："txt" | "json"、任意、デフォルト："txt"）：出力形式。
    • tokens（number、任意）：応答の最大トークン数。
  • 戻り値： Context7 からの結果を含むテキストコンテンツ（プレーンテキストまたは JSON 文字列）。

• c7_search

  • 説明： キーワードで利用可能な Context7 プロジェクトを検索します。
  • パラメーター（object）：
    • term（string、必須）：プロジェクトのタイトルから検索するキーワード。
  • 戻り値： 一致するプロジェクトの JSON 文字列配列を含むテキストコンテンツ。各プロジェクトには、title と（使用可能なプロジェクト名である）name が含まれます。

• c7_info

  • 説明： 特定の Context7 プロジェクトのメタデータを表示します。
  • パラメーター（object）：
    • projectname（string、必須）：正確なプロジェクト名。
  • 戻り値： プロジェクトのすべてのメタデータを表す JSON 文字列を含むテキストコンテンツ。

リソース

• c7_projects_list
  • URI： context7://projects/list
  • 説明： 利用可能で有効な Context7 プロジェクトの一覧を提供します。
  • 戻り値： プロジェクトオブジェクトの JSON 文字列配列を含む、mimeType: "application/json" のコンテンツ。

開発

1. リポジトリをクローンします。
2. 依存関係をインストールします（npm install または bun install）。
3. サーバーをビルドします（npm run build）。開発中に自動で再ビルドして起動するには、npm run dev を使用します。
4. ローカルテスト用にリンクします（npm link または bun link）。
5. MCP Inspector を使用してテストします（npx @modelcontextprotocol/inspector c7-mcp-server）。
6. src/ ディレクトリ内で変更を加え、再ビルドします。

ライセンス

MIT