CUDA-Q Docs

cudaq-docs-mcp

NVIDIA CUDA-Q のドキュメント、API リファレンス、実行可能なサンプルを AI エージェントに提供する MCP サーバーです。実際にインストールされている cudaq のバージョンに固定して回答します。

コミュニティプロジェクトであり、NVIDIA とは提携しておらず、NVIDIA の推奨を受けたものでもありません。CUDA-Q は NVIDIA Corporation の商標です。

概要

量子 SDK は、モデルのトレーニングデータよりも速く進化します。AI アシスタントに CUDA-Q コードの作成を依頼すると、記憶している情報をもとに、名前が変更された API、廃止されたターゲット名、実行しているバージョンとは異なるインストール手順を回答することがあります。原因はバージョンのずれで、オンボーディングで最も重要な最初の 10 分に問題が起こります。

このサーバーは、MCP に対応したエージェントに代わりに最新の回答を提供します。インストール済みの cudaq パッケージに合致するドキュメントのインデックスから、ドキュメント検索、正確な API シンボルの解決、実行可能な完全なサンプル、バックエンド選択ガイドを提供します。API キーも埋め込みも不要です。SQLite の全文検索と BM25 ランキングを使用し、インデックス作成後はオフラインでお使いのマシン上で動作します。

クイックスタート

クライアントにサーバーを登録してください。初回の使用時に、ビルド済みのインデックス（数メガバイト）が自動的にダウンロードされます。ローカルでのビルドが必要なのは、ビルド済みのアセットがないバージョンのみです。

uvx cudaq-docs-mcp build --version 0.14.0

Claude Code

claude mcp add cudaq-docs -- uvx cudaq-docs-mcp

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）、または JSON サーバーマップを受け取る任意のクライアント：

{
  "mcpServers": {
    "cudaq-docs": {
      "command": "uvx",
      "args": ["cudaq-docs-mcp"]
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "cudaq-docs": {
      "type": "stdio",
      "command": "uvx",
      "args": ["cudaq-docs-mcp"]
    }
  }
}

pip を使う場合は、pip install cudaq-docs-mcp を実行し、コマンドとして cudaq-docs-mcp を使用してください。

ツール

ツール	返される内容
search_docs(query, version?, limit?)	パンくずリストと正規 URL を含む、ランキング順のドキュメント抜粋
get_page(path, version?)	クリーンな Markdown 形式のドキュメントページ全体
find_api(name, language?, version?)	正確な Python または C++ のシンボル、種類、ドキュメント URL、抜粋
search_examples(query, language?, version?, limit?)	該当リリースの CUDA-Q リポジトリにある、実行可能な完全なプログラム
list_targets(category?)	シミュレーター、ハードウェアプロバイダー、クラウドを含む 24 個すべての実行ターゲット。選択用スニペットと用途のガイダンスも含みます

リソース：cudaq://versions（インストール済みバージョンとインデックス済みバージョン）および cudaq://llms.txt（提供対象のバージョンに対応する CUDA-Q 独自の llms.txt）。

バージョンに固定した回答

各ツールは、次の順序でドキュメントのバージョンを解決します。

1. 明示的な version 引数（「0.15.0」、「latest」）
2. ディストリビューションメタデータから検出された、インストール済みの cudaq パッケージ（cudaq はインポートされません）
3. latest

インデックスはバージョンごとに用意されています。固定したバージョンのインデックスがない場合、サーバーはそのことを応答で示し、代わりに latest を提供するとともに、解決に必要なコマンドを案内します。バージョンのずれが、気づかないままになるのではなく、見えるようになります。

仕組み

CUDA-Q は元データとして、すべてのページと API シンボルを一覧にした Sphinx インベントリ（objects.inv）、各ドキュメントページの Markdown ミラー、バージョンごとの llms.txt、リポジトリ内のサンプルソースを公開しています。このサーバーは、これらを基盤として次の処理を行います。

• objects.inv をクロールマニフェスト兼 API シンボルテーブルとして使用し、スクレイピングのためのヒューリスティックは使いません
• 各 Markdown ミラーからテーマの装飾を除去し、コードブロックを言語情報付きで再構築し、見出しアンカーを維持してディープリンクに対応します
• 見出しごとにページをチャンク化し、SQLite FTS5（Porter ステミング、BM25 ランキング）でインデックス化します
• ドキュメントのバージョンに一致する GitHub リリースタグから、サンプル、スニペット、アプリケーションのソースを取得します

インデックス全体は、キャッシュディレクトリ内のバージョンごとに 1 つの SQLite ファイルに保存されます（保存先は cudaq-docs-mcp info で確認できます）。ナイトリーワークフローで latest のインデックスを再構築するため、更新時に必要なのはビルドではなくダウンロードだけです。

CLI

cudaq-docs-mcp            # serve MCP on stdio (what clients run)
cudaq-docs-mcp build      # build the index for your installed cudaq, else latest
cudaq-docs-mcp build --version 0.15.0
cudaq-docs-mcp info       # cache location, indexed versions, detected cudaq

初回使用時に自動でビルドするには CUDAQ_DOCS_MCP_AUTOBUILD=1 を設定し、キャッシュの保存先を変更するには CUDAQ_DOCS_MCP_CACHE を設定してください。

ロードマップ

• latest だけでなく、固定されたリリースバージョンのビルド済みインデックスを提供
• 実際の開発者の質問を集めた評価セットを作成し、検索スコアを公開
• CUDA-QX ライブラリのドキュメント

貢献

Issue と PR を歓迎します。コミットには DCO のサインオフ（git commit -s）が必要です。CONTRIBUTING.md をご覧ください。Claude Code とともにオープンに開発しています。

ライセンス

Apache-2.0。ドキュメントの内容は NVIDIA Corporation & Affiliates に帰属し、Apache-2.0 ライセンスの NVIDIA/cuda-quantum リポジトリに由来します。また、提供されるすべての結果は正規のページへのリンクを含みます。NOTICE をご覧ください。