oss-search について
oss-searchは、ローカルおよびフェデレーテッドなオープンソースコード検索とリポジトリ探索を行うMCPサーバーで、同等のコマンドラインツールも備えています。標準入出力で7つのMCPツールを提供し、`--live`でリモートバックエンドを有効にできます。
主な機能
- 01ローカルのオープンソースコード検索
- 02フェデレーテッドコード検索
- 03リポジトリの探索
- 04標準入出力による7つのMCPツール
- 05同等のコマンドラインツール
- 06Rustバイナリのキャッシュ
活用シーン
- 01オープンソースプロジェクト内のコード検索
- 02関連リポジトリの探索
- 03`--live`によるリモートソース検索
- 04MCPまたはコマンドラインでの検索
MCP 対応
標準入出力を通じて、コード検索とリポジトリ探索の7つのツールをMCPクライアントに提供します。コマンドラインツールでも同じ機能を利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
oss-mcp(npm 配布版)
oss-search の npm/npx 配布版です。高速なローカル検索と連携型の OSS コード検索、リポジトリ探索を提供し、stdio 経由で 7 つの MCP ツールを公開するとともに、バイト単位で同一の CLI も提供します。
このパッケージにはコンパイル済みコードが含まれておらず、実行時依存関係はゼロです。初回実行時に、oss-mcp シムが GitHub Releases からプラットフォーム用のビルド済み Rust バイナリをダウンロードし、リリースの checksums.txt がある場合は照合してからキャッシュします。2 回目以降は、キャッシュからすぐに起動します。
必要条件
- Node.js >= 18(バイナリの初期セットアップにのみ使用)
- macOS(x64、arm64)または Linux(x64、arm64)
oss-mcpバイナリを含むoss-search-<version>-<target>.tar.gzと、任意でchecksums.txtという名前のアセットを含む公開済みリリースv<version>
1 回だけ実行
npx oss-search # speaks MCP over stdio
npx oss-search --live # enable remote backends (GitHub code search, grep.app, deps.dev, ...)
グローバルにインストール
npm install -g oss-search
oss-mcp
MCP クライアントで使用
{
"mcpServers": {
"oss-search": {
"command": "npx",
"args": ["oss-mcp"]
}
}
}
Node のシムを完全に省略するには、キャッシュ済みバイナリ(~/.cache/oss-search/bin/<version>-<target>/oss-mcp)を直接指定することもできます。
キャッシュ
バイナリは ~/.cache/oss-search/bin/<version>-<target>/oss-mcp にキャッシュされます。保存場所は OSS_SEARCH_CACHE_DIR 環境変数で変更できます。キャッシュを削除すると、再ダウンロードが行われます。
GITHUB_TOKEN を使用したライブ検索などのオプションについては、リポジトリの README をご覧ください。
ライセンス
MIT — LICENSE をご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。