codesearch

codesearch MCP サーバー

mcp-name: io.github.SK-DEV-AI/codesearch

· npx skills add SK-DEV-AI/skills

コード、パッケージ、ドキュメント、論文を検索する MCP サーバーです。パッケージ単位のソースナビゲーション（npm/PyPI/crates）、リポジトリ単位のインテリジェンス（GitHub URL または owner/repo）、Q&A コミュニティ、脆弱性データ、ドキュメント、学術論文を提供します。埋め込みによる重複排除と、ローカルのクロスエンコーダー再ランキング機能を備えています。

ツール（17）

• analyze — 詳しく知らないリポジトリを調べるときは、ここから始めましょう。GitHub メタデータ、コード品質、Wiki アーキテクチャを1回の呼び出しで取得します（10～15秒）。
• search_all — 複数のソースを幅広く検索します（Context7、GitHub、DeepWiki、CodeWiki、SO、HN、Libraries.io、npm、DevDocs、Semantic Scholar、Tavily など）。特定のソースをピンポイントで調べる場合は、以下のツールを直接呼び出してください。
• code_search — インデックス化された依存関係（target=npm:express）全体からコード、ドキュメント、シンボルを検索します。npm/PyPI/crates のみが対象です。GitHub リポジトリを検索する場合は、searchcode または analyze を使用してください。
• code_files / code_read — パッケージ指定に基づき、インデックス化された依存関係内のファイルを一覧表示／読み込みます。
• searchcode — リポジトリ単位のインテリジェンスです。analyze（概要）、search（リポジトリ内のコード検索）、findings（品質上の問題）、file_tree、get_file を利用できます。すべてのアクションで repository が必要です。無料で、認証も不要です。
• wiki — DeepWiki と CodeWiki を使ったリポジトリアーキテクチャの Q&A です。単一のリポジトリ（owner＋repo）、または最大10件のリポジトリ（repos）に対応しています。
• search_package — レジストリを直接検索します。バージョン、dist-tag、deps.dev グラフ、アドバイザリに対応しています（version='latest' も使用できます）。複合的なインテリジェンスには pkg を使用してください。
• pkg — パッケージの複合的なインテリジェンスを提供します。メタデータ、変更履歴、アップグレードレビュー（脆弱性＋変更履歴＋依存関係の差分）、ファイル一覧／読み込みに対応しています。
• search_libraries — Libraries.io のメタデータとソースランキングを取得します。依存関係の候補を比較したり、パッケージの背後にあるリポジトリを探したりできます。
• vulns — Sonatype Guide と、キー不要の OSV.dev フォールバックに対応しています。scan（platform＋name＋version が必要）、detail（vuln_id が必要。NVD CVSS/CWE/参照情報を追加）、latest_version／license（purl が必要）を利用できます。
• docs — スマートフォールバック（Context7 → ReadTheDocs → llms.txt → DevDocs）でドキュメントを検索します。その後、fetch(url) または devdocs_fetch_content でページ全体を取得できます。
• so_search — Stack Overflow を検索します。stackexchange（信頼性の高い、解決済みの回答）または sofa（より新しいエージェント向けコンテンツ。SOFA_KEY が必要）を利用できます。
• hn — Hacker News の議論とセンチメントを検索します（検索、ストーリー、アイテム、ユーザー）。
• papers — 学術論文を検索します。action=search（S2 → arXiv → OpenAlex → CORE のフォールバックチェーン）を推奨します。arxiv_search は単一ソースを対象とし、レート制限があります。
• enrich — 任意の検索ツールが返した結果リストについて、コンテンツ全体を取得し、重複を排除して再ランキングします。
• ping — 接続を確認します。不確かな場合は、時間のかかる呼び出しの前に使用してください。

セットアップ

Python 3.14 以降が必要です。

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp run.example run   # fill in your API keys (run is gitignored — never commit it)
chmod +x run

MCP クライアントで run（stdio）を指定してください。

{ "codesearch": { "command": "/path/to/codesearch/run" } }

API キー（run）

キー	用途	必須？
GITHUB_TOKEN	GitHub API（リポジトリ操作、レート制限の緩和）	推奨
CONTEXT7_API_KEY	Context7 ドキュメント	任意
TAVILY_KEYS	search_all の Tavily レーン	任意
S2_API_KEY	Semantic Scholar（共有の匿名プールに対し、専用の1 rps）	任意
SE_API_KEY / SOFA_KEY	Stack Exchange / Stack Overflow for Agents	任意
LI_KEY	Libraries.io	任意
OSS_TOKEN	Sonatype OSS Index	任意
FIRECRAWL_KEYS	Firecrawl フォールバック	任意
NV_KEY	NVIDIA 埋め込みエンドポイント	任意

PyPI からインストール

pip install skdev-codesearch-mcp          # core install, small
pip install skdev-codesearch-mcp[all]     # + browser/OCR/extract extras (multi-GB)

codesearch-mcp コンソールスクリプトは、stdio 経由で MCP と通信します。

{ "codesearch": { "command": "codesearch-mcp" } }

Docker

docker build -t codesearch-mcp .
docker run --rm -i codesearch-mcp

キーは実行時に渡し、イメージに埋め込むことはありません：-e GROQ_API_KEYS=...。 容量の大きい追加機能：docker build --build-arg EXTRAS="[all]" -t codesearch-mcp .

注意事項

• リランカー（任意、ローカル）： Websearch サーバーと共有される、Unix ソケット経由のクロスエンコーダーワーカーです。これがない場合、結果はランキングされずに返されますが、すべての機能は引き続き動作します。
• キャッシュ： ソースごとに TTL 付きのファイルキャッシュを使用するため、繰り返しのクエリは低コストです。
• 安全性： ユーザー指定 URL の取得はすべて SSRF 検証されます（プライベート IP のブロックと、リダイレクトの各ホップでの再検証）。