repowiki

repowiki

repowiki は、公開 GitHub リポジトリのドキュメント Wiki を作成するサービス DeepWiki のコマンドラインとローカル MCP サーバーを提供します。owner/repo 形式でリポジトリを指定すると、そのプロジェクトについて DeepWiki が作成したトピックの一覧や、ドキュメント全文を取得したり、DeepWiki 独自のインデックスとモデルを使ってコードベースに関する平易な言葉での質問に回答したりできます。

回答は DeepWiki の公開ホスト型サービスから取得されます。このサービスは無料で、アカウントや API キーは不要です。repowiki はローカル側を担い、文書化されたプロトコルでサービスと通信して、同じ 3 つのツールを stdio 経由で提供します。そのため、リモートトランスポートを設定しなくても、どの MCP クライアントからでも利用できます。

インストール

npx @reneturcios/repowiki structure facebook/react

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/repowiki

コンテナーはデフォルトで MCP サーバーとして動作します（下記を参照）。CLI として使うには、CLI 引数を渡してください。

CLI

# List the documentation topics for a repository
repowiki structure facebook/react

# Print the full documentation text
repowiki contents facebook/react

# Ask a question about the repository
repowiki ask facebook/react "How is state managed?"

repowiki --version

終了コード：成功時は 0、上流サービスがエラーを返すか接続できない場合は 1、使用方法に誤りがある場合は 2 です。リポジトリ名は owner/repo 形式で指定する必要があります。それ以外の形式は、リクエストを送信する前に拒否されます。

MCP サーバー

1 つの実行ファイルがどちらの用途にも対応します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/repowiki mcp

MCP クライアントの設定：

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

ツール

ツール	入力	返される内容
read_wiki_structure	repoName（文字列、必須、owner/repo）	リポジトリについて DeepWiki が用意しているドキュメントのトピック一覧。
read_wiki_contents	repoName（文字列、必須、owner/repo）	リポジトリのドキュメント全文。
ask_question	repoName（文字列、必須）、question（文字列、必須）	コードとドキュメントの DeepWiki インデックスに基づく、リポジトリに関する回答。

内部では、各呼び出しが JSON-RPC tools/call リクエストとして DeepWiki のホスト型 MCP エンドポイント（https://mcp.deepwiki.com/mcp）に転送されます。レスポンスは通常の JSON または Server-Sent Events ストリームとして届き、結果のテキストに変換されます。認証情報は送信されません。公開サービスでは認証情報が不要なためです。非公開リポジトリは対象外です。上流サービスと同様、アクセスできるのは公開リポジトリのみです。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。