Code Research MCP Server

Code Research MCP Server

複数のプラットフォームにわたるプログラミングリソースを検索・利用するためのツールを提供する、Model Context Protocol サーバーです。このサーバーは、人気の開発者向けプラットフォームと連携し、LLM が関連するコード例、ドキュメント、パッケージを見つけられるよう支援します。

機能

対応プラットフォーム

• Stack Overflow - プログラミングに関する Q&A
• MDN Web Docs - ウェブ開発ドキュメント
• GitHub - コードとリポジトリの検索
• npm - JavaScript パッケージレジストリ
• PyPI - Python パッケージインデックス

ツール

search_stackoverflow

Stack Overflow でプログラミングに関する質問と回答を検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • limit（任意）：最大結果数（1～10、デフォルト：5）
• 戻り値：スコア、回答数、抜粋を含む、質問の書式付きリスト
• 結果は1時間キャッシュされます

search_mdn

MDN Web Docs でウェブ開発ドキュメントを検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
• 戻り値：概要とリンクを含む、上位5件の MDN ドキュメントの検索結果
• 結果は1時間キャッシュされます

search_github

GitHub でリポジトリとコード例の両方を検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • language（任意）：プログラミング言語で絞り込み
  • limit（任意）：カテゴリーごとの最大結果数（1～10、デフォルト：5）
• 戻り値：次の2つのセクション：
  1. スター数順の上位リポジトリ
  2. リポジトリの情報を含む関連コードファイル
• 結果は1時間キャッシュされます

search_npm

npm レジストリで JavaScript パッケージを検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • limit（任意）：最大結果数（1～10、デフォルト：5）
• 戻り値：バージョン、説明、ダウンロード統計などのパッケージ情報
• 結果は1時間キャッシュされます

search_pypi

PyPI で Python パッケージを検索します。

• パラメーター：
  • query（必須）：検索クエリ文字列
• 戻り値：バージョン、作成者、リンクなどの詳細なパッケージ情報
• 結果は1時間キャッシュされます

search_all

すべてのプラットフォームを同時に検索し、幅広い結果を取得します。

• パラメーター：
  • query（必須）：検索クエリ文字列
  • limit（任意）：プラットフォームごとの最大結果数（1～5、デフォルト：3）
• 戻り値：すべてのプラットフォームから統合した結果：
  1. Stack Overflow の質問と回答
  2. MDN ドキュメント
  3. GitHub のリポジトリとコード
  4. npm パッケージ
  5. PyPI パッケージ
• 結果は1時間キャッシュされます
• 注：応答を高速化するため、すべての検索を並行して実行します

必要条件

• Node.js >= 20.11.0
• npm >= 10.0.0
• 任意：API のレート制限を緩和するための GitHub 個人アクセストークン

インストール

Smithery 経由でのインストール

Smithery 経由で Code Research Server を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @nahmanmate/code-research-mcp-server --client claude

手動インストール

1. リポジトリをクローンし、依存関係をインストールします：

git clone https://github.com/nahmanmate/code-research-mcp-server.git
cd code-research-server
npm install

2. サーバーをビルドします：

npm run build

3. MCP 設定を構成します：

サーバーの設定を MCP 設定ファイルに追加します：

• VSCode：~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Claude Desktop：
  • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "code-research": {
      "command": "node",
      "args": ["/absolute/path/to/code-research-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"  // Optional: Prevents rate limiting
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

注：/absolute/path/to は、リポジトリをクローンした実際のパスに置き換えてください。

開発

開発モードでの実行

変更時に自動で再ビルドする開発環境を実行するには：

npm run watch

エラー処理

サーバーは堅牢なエラー処理を実装しています。

• 各プラットフォームに固有の API エラーメッセージ
• GitHub API のレート制限への対応
• サービスが利用できない場合の適切なフォールバック
• API の負荷を軽減するキャッシュ済みレスポンス

デバッグ

MCP サーバーは標準入出力（stdio）経由で通信するため、デバッグが困難な場合があります。詳細なリクエスト／レスポンスの監視には、MCP Inspector を使用してください。

npm run inspector

Inspector では、次の情報を確認できます。

• リクエスト／レスポンスのリアルタイム監視
• ツール実行のトレース
• エラースタックトレース
• パフォーマンス指標

提供された URL にブラウザーからアクセスして、デバッグインターフェースを使用してください。

キャッシュ

結果は node-cache を使用してキャッシュされます。

• デフォルトの TTL：1 時間
• クエリと上限の組み合わせごとに個別のキャッシュキーを使用
• プラットフォーム固有のキャッシュ戦略
• メモリー効率の高いストレージ

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

ライセンス

AGPLv3