大規模なコードベースを扱うAIコーディングアシスタントの限界に不満を感じていた開発者が、ローカル環境で動作する革新的なMCPサーバー「Semantiq」を開発しました。外部APIキー不要、19言語対応、4つの検索戦略を組み合わせた高精度なコード検索を実現するこのツールは、Claude Code、Cursor、Windsurfなど、あらゆるAIコーディングツールで利用可能です。
この記事のポイント
- セマンティック検索、字句検索、シンボル検索、依存関係グラフの4戦略を統合
- 19言語に対応したtree-sitter解析、解析精度99.9%
- OpenAI API不要、すべてローカルで完結（SQLite + sqlite-vec）
- ファイル監視による自動インデックス更新、手動リフレッシュ不要
AIコーディングアシスタントの課題
現在のAIコーディングアシスタントの多くは、大規模コードベースの処理に課題を抱えています。基本的なgrep検索に頼っているツールは、コードの意味的な関係性を理解できません。一方、高度な機能を提供するツールは、高額なクラウドサービスやAPIキーが必要になることが多いです。
開発者のAdMoist8407氏は、この状況に不満を感じ、すべてがローカルで動作し、外部依存なしに深い意味的理解を提供できるMCPサーバーの開発に着手しました。その成果がSemantiqです。
4つの検索戦略の統合
Semantiqの最大の特徴は、4つの異なる検索戦略を組み合わせて使用することで、単一のアプローチでは得られない精度を実現している点です。
セマンティック検索
MiniLM埋め込みモデルを使用して、コードの意味的な類似性を検索します。変数名やコメントが異なっていても、同じ機能を持つコードを見つけることができます。
字句検索
ripgrepを活用した高速なテキストマッチングです。正確な文字列やパターンを素早く検索できます。
シンボル検索
FTS5（Full-Text Search 5）を使用した完全一致検索です。関数名、クラス名、変数名などのシンボルを正確に検索できます。
依存関係グラフ分析
コード間のインポート関係や依存関係を分析し、コードの構造を可視化します。特定のモジュールがどこで使われているか、変更の影響範囲はどこまでかを把握できます。
19言語への対応
Semantiqは、tree-sitterパーサーを使用して19の言語に対応しています。完全サポートされている言語には、Rust、TypeScript、JavaScript、Python、Go、Java、C、C++、PHP、Ruby、C#、Kotlin、Scala、Bash、Elixirが含まれます。また、HTML、JSON、YAML、TOMLも部分サポートされています。
解析精度は99.9%、シンボル認識率は100%という高い精度を実現しています。これにより、AIコーディングアシスタントはコードベース全体を正確に理解した上でサポートを提供できます。
MCPツールセット
Semantiqは以下の4つのMCPツールを提供します：
| ツール名 | 機能 |
|---|---|
| semantiq_search | 4つの検索戦略を組み合わせた統合検索 |
| semantiq_find_refs | シンボルの定義と使用箇所をすべて検出 |
| semantiq_deps | インポート関係と依存関係を分析 |
| semantiq_explain | シンボルの詳細説明を生成 |
完全ローカル動作のメリット
Semantiqの大きな利点は、すべての処理がローカルマシン上で完結することです。OpenAI APIやその他の外部サービスへの接続は一切必要ありません。データベースにはSQLiteとsqlite-vecを使用し、埋め込みベクトルの保存と検索もローカルで行います。
これにより、以下のメリットが得られます：
– プライバシー：コードが外部サーバーに送信されることがない
– コスト：API料金が発生しない
– オフライン動作：インターネット接続なしで使用可能
– 低レイテンシー：ネットワーク遅延がない
実践してみよう
npmを使って簡単にインストールできます：
npm install -g semantiq-mcp
cd your-project
semantiq init # 設定を自動構成
initコマンドを実行すると、プロジェクトの解析が始まり、インデックスが構築されます。以降はファイルの変更を自動的に検出し、インデックスを更新してくれるため、手動でのリフレッシュは不要です。
知っておくと便利なTips
- camelCaseとsnake_caseの自動変換: 検索クエリは自動的に両方の命名規則で検索されるため、正確な表記を覚えていなくても検索できます
- 企業向けセキュリティ: パストラバーサル保護、SQLインジェクション防止、DoS対策が実装されているため、チーム環境でも安心して使用できます
- MITライセンス: 永久無料で利用可能なオープンソースプロジェクトです。商用利用も含めて自由に使用できます
- 複数ツールとの連携: Claude Code、Cursor、Windsurfなど、MCP対応のあらゆるツールで利用できます
まとめ
Semantiqは、AIコーディングアシスタントの能力を大幅に拡張する革新的なMCPサーバーです。外部依存なしで高度な意味的検索を実現し、19言語に対応した解析能力を提供します。ローカル完結型のアーキテクチャにより、プライバシー、コスト、パフォーマンスの面で大きなメリットがあります。大規模コードベースを扱う開発者や、AIコーディングアシスタントをより効果的に活用したい方にとって、Semantiqは検討に値するツールです。
📎 元記事: https://www.reddit.com/r/ClaudeAI/comments/1qi75uf/i_built_semantiq_a_universal_mcp_server_that/
コメント