DeepWiki MCPをClaude Codeで使う — 公開リポジトリのドキュメントを検索・引用する
DeepWiki MCPサーバーをClaude Codeに追加する手順と、GitHub公開リポジトリのドキュメントを検索・引用する使い方をまとめます。認証不要で誰でも接続できます。
DeepWiki MCPは、GitHubの公開リポジトリ向けに自動生成されたドキュメントを、Claude Codeから直接検索・引用できるようにするリモートMCPサーバーです。認証設定が要らず、claude mcp addの1コマンドで接続できます。この記事では接続手順と、実際に使える3つのツール、通信方式やクライアントごとの設定差、制限事項までをまとめます。
DeepWiki MCPとは
DeepWikiは、AIコーディングエージェント「Devin」のエコシステムの一部として提供されているサービスです。GitHubの公開リポジトリに対して、アーキテクチャ図・ドキュメント・ソースコードへのリンクを自動生成し、deepwiki.comで閲覧できます。React・TensorFlow・LangChainのような有名OSSはすでに索引済みで、任意の公開リポジトリのURLを送って生成させることもできます。
DeepWiki MCPは、このドキュメント化データをプログラムから呼び出すための窓口です。公式ドキュメントによれば、無料・リモート・認証不要でホスティングされています。
- ベースURL:
https://mcp.deepwiki.com/ - 料金: 無料
- 認証: 不要
- 対象: GitHubの公開リポジトリのみ
プライベートリポジトリは対象外です。非公開コードを扱いたい場合は、Devinアカウントを作成しAPIキーで認証する別サーバー「Devin MCP server」を使う必要があります。
利用する側でリポジトリを事前登録する必要は基本的にありません。対象リポジトリが未索引の場合は、deepwiki.com上でURLを送信すると生成されます。
前提条件
DeepWiki MCPを使うのに、Devinのアカウントや料金プランは不要です。Claude Code側で必要な前提は次の2点だけです。
- Claude Code CLIがインストール済みで、
claude mcp addコマンドが使えること mcp.deepwiki.comへの外向き通信が許可されていること(社内プロキシ経由の環境では、他の外部MCPサーバーと同様に許可設定が必要になる場合があります)
APIキーやアクセストークンの発行は不要です。
使える3つのツール
DeepWiki MCPサーバーが公開するツールは3つです。いずれもリポジトリ単位で呼び出します。
| ツール名 | できること |
|---|---|
read_wiki_structure | できること対象リポジトリのドキュメントトピック一覧を取得する |
read_wiki_contents | できることトピックに対応するドキュメント本文を取得する |
ask_question | できることリポジトリについて自由文で質問し、コードに基づいた回答を得る |
ask_questionは単なるキーワード検索ではありません。DeepWiki側でリポジトリのコードとドキュメントを踏まえた回答を生成するため、Claude Codeが自力でリポジトリ全体を読み込まなくても、要点を先に把握できます。
3つのツールはいずれも、対象リポジトリのソースコードそのものではなく、DeepWiki側であらかじめ生成済みの「wiki」を参照します。リポジトリのファイルツリーを直接返すツールではない点は、GitHub本体のAPIやリポジトリ専用MCPサーバーとの違いとして押さえておくとよいでしょう。
Claude Codeへの接続手順
追加はclaude mcp addコマンド1つで完了します。HTTPサーバーとして、ユーザースコープ(全プロジェクト共通)で登録する例です。
claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp-sは--scope、-tは--transportの短縮形で、いずれも公式ドキュメントが認めている書き方です。スコープを省略するとローカル(そのプロジェクトのみ)登録になるため、複数プロジェクトで使い回したいなら-s userを明示します。
接続状態はclaude mcp list、またはセッション内の/mcpコマンドで確認できます。
/mcpdeepwikiが一覧に表示され、接続エラーが出ていなければ準備完了です。
実際の使い方 — 公開リポジトリを検索・引用する
接続後は、Claude Codeへの指示にリポジトリ名を含めるだけでツールが呼ばれます。たとえば次のような指示です。
- 「
facebook/reactのフックの実装をDeepWikiで調べて、useEffectのクリーンアップの挙動を教えて」 - 「
langchain-ai/langchainのドキュメント構成をread_wiki_structureで一覧して」 - 「依存に追加しようとしている
upstash/context7が何をするツールか、DeepWikiで確認して」
Claude Codeは指示の内容からread_wiki_structure・read_wiki_contents・ask_questionのどれを呼ぶかを判断します。対象のリポジトリ名をowner/repoの形で明示すると、狙ったリポジトリに絞り込みやすくなります。
依存先ライブラリの使い方を調べる場面では、ローカルにクローンしなくても、公開リポジトリのドキュメントをその場で引用できるのが利点です。回答にはDeepWiki側が生成したドキュメントの文言がそのまま含まれることがあるため、そのまま引用する際は一次ソース(GitHubリポジトリ本体)の記載とも突き合わせておくと安全です。
通常、Claude Codeが未知のOSSを調べるときは、WebFetchでREADMEや個別ファイルを都度取得するか、リポジトリをクローンしてソースを読む必要があります。DeepWiki MCPを挟むと、すでに要約・構造化されたドキュメントが返るため、ソースコード全体を読み込まずに済む場面が増えます。目的の情報がどのファイルにあるか分からない段階では、ask_questionで先に見当をつけてから該当ファイルを開く、という順序が効率的です。
DeepWiki MCPが向く場面・向かない場面
| 場面 | 向き不向き | 理由 |
|---|---|---|
| 初めて触るOSSの全体構成を把握したい | 向き不向き◎ | 理由read_wiki_structureでトピック一覧を素早く俯瞰できる |
| 依存先ライブラリの使い方を素早く質問したい | 向き不向き◎ | 理由ask_questionがコードに基づいた回答を返す |
| すでにローカルにクローン済みのコードを読みたい | 向き不向き△ | 理由ファイル読み込みで足りることが多く、MCP経由の必要性は薄い |
| 自社のプライベートリポジトリを調べたい | 向き不向き× | 理由公開リポジトリ専用。非公開コードはDevin MCP serverが別途必要 |
対応する通信方式とクライアントによる設定差
DeepWiki MCPはStreamable HTTP(/mcp)とSSE(/sse、レガシー)の2つのワイヤープロトコルに対応しています。公式ドキュメントは/mcpエンドポイントについて、Cloudflare・OpenAI・Claudeとの互換性を確認済みと明記しており、新規に接続する場合はこちらを使う想定です。Claude Codeのclaude mcp add --transport httpは、まずHTTPで接続を試み、サーバー側が受け付けない場合にSSEへ自動的に切り替える仕様なので(Claude Code v2.1.265以降)、通常はこの自動判定だけで問題なく接続できます。
接続先URLをJSON設定に直接書く場合は、クライアントごとにフィールド名が違う点に注意が必要です。
| クライアント | URLを書くフィールド | 備考 |
|---|---|---|
| Devin Desktop | URLを書くフィールドserverUrl | 備考他クライアントとは異なる専用フィールド名 |
| Cursorなど多くのクライアント | URLを書くフィールドurl | 備考MCP仕様に沿った標準的な書き方 |
Claude Code(.mcp.jsonを手動編集) | URLを書くフィールドurl + type: "http" | 備考typeを省くとstdioサーバーとして解釈され、接続に失敗する |
claude mcp addコマンド経由で追加する場合は、Claude Code側がこのtypeフィールドを自動で補うため、この差分を意識する必要はありません。手動でJSONを書くときだけ気をつければよい話です。.mcp.jsonの書き方やスコープの使い分けはClaude Code MCP設定ガイドにまとめています。
制限事項とよくあるつまずき
- 公開リポジトリのみ: プライベートリポジトリはDeepWiki MCPの対象外です。非公開コードを調べたい場合はDevinアカウントを作成し、APIキーで認証する別サーバーに切り替える必要があります
- 書き込みはできない: 提供されているのは
read_wiki_structure/read_wiki_contents/ask_questionの3つで、いずれも読み取り専用です。リポジトリへの変更は行えません - JSON設定を手動で書くときのフィールド名:
.mcp.jsonを直接編集する場合、urlに加えてtype: "http"を書き忘れるとstdioサーバーとして扱われ、接続に失敗します。claude mcp addコマンドを使えばこの問題は起きません - SSEは非推奨:
/sseエンドポイントはレガシー扱いです。新規に接続する場合は/mcpを使う設定(セットアップ手順どおり)にしておけば、廃止の影響を受けません - リポジトリ名はowner付きで明示する: 対象リポジトリの指定があいまいだと、意図しないリポジトリのドキュメントが返る可能性があります。指示には
facebook/reactのようにowner付きの正式名称を含めます
他のMCPサーバーとの通信方式・認証方式の違いをまとめて比較したい場合は、AIコーディングエージェントのMCP対応状況を比較する記事が参考になります。プロジェクト単位でMCPサーバーの読み込みを絞りたい場合は--mcp-configと--strict-mcp-configの使い分け、OAuth認証が必要な別サーバーをCLIから扱う場合はclaude mcp login/logoutの使い方も合わせて確認しておくと、接続まわりのつまずきを減らせます。
まとめ
DeepWiki MCPは、claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcpの1コマンドで、Claude Codeに公開GitHubリポジトリの検索・引用機能を追加できるサービスです。認証設定は不要で、read_wiki_structure・read_wiki_contents・ask_questionの3ツールを使い分ければ、初めて触るOSSの全体像の把握や、依存先ライブラリの仕様確認をローカルクローンなしで進められます。対象は公開リポジトリに限られるため、社内のプライベートリポジトリを調べたいチームは、Devinアカウントと専用MCPサーバーを使う別経路が必要になる点だけ覚えておくとよいでしょう。他のMCPサーバーを併用したい場合は、Gitea・GitHubのような個別サービス向けの設定手順も参考にしてください。Gitea MCPサーバーの使い方では、セルフホストのGitリポジトリをClaude Codeから操作する手順を扱っています。