grooveseek

GrooveSeekは、Markdownファイルの知識ベースに対して意味検索と全文検索を組み合わせたハイブリッド検索を行うMCPサーバです。プレーンテキスト、PDF、Officeドキュメント、ソースコードはオプトインで利用できます。コマンドは`groove`です。 初期状態では、設定ファイルなしかつデフォルトモデルで、YAML frontmatterを持つ英語Markdownを索引付けします。多言語または日本語コンテンツには`--model bge-m3`が必要です。その他のファイル形式は`groove.toml`で有効にします。 仕組み: Markdown（任意で`.txt`、`.pdf`、`.docx`、`.xlsx`、`.pptx`、さらにv1.2.0以降はRust、v1.3.0以降はPython、v1.5.0以降はPHPのソースコード。これらの文法は手動でダウンロードして配置します）は、YAML frontmatterとともに解析され、見出しベースのチャンクに分割されます。ソースコードの場合は定義ごとに1チャンクとなります。埋め込みはデフォルトでFastEmbedにより生成され（BGE-small-en-v1.5、多言語知識ベースではBGE-M3）、ベクトル類似度検索のためにsqlite-vecを使ってSQLiteに保存されます。信頼できる設定では、OpenAI互換の埋め込みエンドポイントを代わりに選択できます。 クライアントはstdio（デフォルト、1クライアント）またはStreamable HTTP（複数クライアント）で接続するため、Claude Code、Cursor、または任意のMCP互換クライアントで動作します。ライブ同期のファイルウォッチャーが、手動編集、`git pull`、外部スクリプトによる変更で索引を最新に保ちます。任意のTOMLスキーマにより、`groove validate`でfrontmatterの規約を検証できます。v1.9.0以降では、スキーマで宣言された追加キーが`groove index`によって保存され、`groove search --field`でフィルタできます。 MCPインターフェースは、`search`、`get_document`、`list_topics`、`get_connection_graph`、`get_best_practice`、`rebuild_index`の6つのツールと、4つのプロンプト、そして知識ベースを`kb://`リソースとして公開します。`--transport http`を使用すると、サーバーは`/ui`でも応答します。このオペレータービューには、バージョン、ドキュメント数とチャンク数、埋め込みモデル、ウォッチャー状態、稼働時間、pidが表示され、検索はクライアントが使用するのと同じ`/mcp`エンドポイントを通じて行われます。 インストールは、Linux x86_64およびaarch64、macOS Apple Silicon、Windows x86_64向けの事前ビルドバイナリに加え、SHA-256チェックサムとGitHub artifact attestationが提供されます。Intel Mac向けビルドはソースから作成する必要があります。ONNX runtimeとSQLiteは静的リンクされ、埋め込みモデルは初回実行時にHuggingFaceからダウンロードされます。ソースからビルドする場合は`cargo build --release`を実行します。 クイックスタートは`groove index --kb-path /path/to/knowledge-base`を実行し、`groove serve --kb-path ...`を指定した`.mcp.json`エントリを追加するか、`groove search "..." --limit 3`で直接クエリします。ドキュメントには、コマンド、設定キー、クライアント構成例、検索パイプライン（RRF、再ランク、MMR、parent retriever）、フィルタ、バイトオフセット付き引用、ゴールデンクエリセットによる評価、アーキテクチャ、安定性保証が記載されています。各ページには日本語版があり、サイトとして公開されています。個人用stdio、NAS共有、イントラネットHTTP構成向けのデプロイ手順も含まれます。1.0.0より前のリリースはベータ版であり、互換性保証はありません。1.0.0以降は、安定性ドキュメントにおいて、WebインターフェースとRust APIを含め、何が固定され、何が意図的に固定されないかが示されます。ライセンスはMITまたはApache-2.0のデュアルライセンスです。