Niivue MCP

🚀 @edziocodes/niivue-mcp

LLMに対して、高速な語彙検索とオプションのセマンティックハイブリッド検索を備えたNiivueのドキュメントとAPIリファレンスを提供するMCPサーバーです。

🚀 クイックスタート

このサーバーを使用することで、NiivueのドキュメントやAPIに対して高速な検索を行うことができます。

✨ 主な機能

• Niivueのドキュメントとガイドの全文検索（BM25 + エンベディング）
• NiivueのTypeScriptソース内のJSDocコメントからのAPI検索
• 概要、検索、リスト表示、ページ取得のための構造化ツール
• 起動とクエリのレイテンシを低く抑えるためのローカルキャッシュ

📦 インストール

npm install @edziocodes/niivue-mcp

💻 使用例

基本的な使用法

MCPクライアントの設定に以下を追加します（例: Claude Desktop, Cursorなど）。

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

高度な使用法

開発環境でのセットアップ

ソースからクローンしてビルドします。

git clone https://github.com/gaiborjosue/niivue-mcp.git
cd niivue-mcp
npm install
npm run build

ローカルで実行するには以下のコマンドを実行します。

npm run dev

エンベディング（ハイブリッド検索）の設定

デフォルトではセマンティックエンベディングを用いたハイブリッド検索が有効になっています。初回使用時にエンベディングモデルがダウンロードされます。 エンベディングを無効にしてBM25検索のみを使用するには、以下のコマンドを実行します。

npx @edziocodes/niivue-mcp --no-embeddings

📚 ドキュメント

利用可能なツール

• get_niivue_overview
• search_niivue_docs
• get_niivue_doc
• list_niivue_docs
• search_niivue_api
• get_niivue_api

キャッシュ

キャッシュは ~/.niivue-mcp に保存されます。

• docs/ 生のマークダウンファイル
• index.json BM25インデックス
• vectors.json ベクトルインデックス（エンベディングが有効な場合）
• api-index.json 解析されたAPIエントリー
• meta.json キャッシュのメタデータ

出典

ドキュメントとソースはNiivueリポジトリから取得されています: https://github.com/niivue/niivue/