Code Research MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Search GitHub for both repositories and code examples through the search_github tool

  • Search MDN Web Docs for web development documentation through the search_mdn tool

  • Search npm registry for JavaScript packages through the search_npm tool

コードリサーチMCPサーバー

複数のプラットフォームにまたがるプログラミングリソースの検索とアクセスのためのツールを提供するモデルコンテキストプロトコルサーバー。このサーバーは一般的な開発プラットフォームと統合されており、LLMが関連するコードサンプル、ドキュメント、パッケージを見つけるのに役立ちます。

特徴

統合プラットフォーム

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

ツール

search_stackoverflow

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

  • パラメータ:
    • query (必須): 検索クエリ文字列
    • limit (オプション): 最大結果数 (1-10、デフォルト: 5)
  • 返されるもの: スコア、回答数、抜粋を含むフォーマットされた質問リスト
  • 結果は1時間キャッシュされます

search_mdn

Web 開発ドキュメントについては、MDN Web Docs を検索してください。

  • パラメータ:
    • query (必須): 検索クエリ文字列
  • 返されるもの: 要約とリンクを含む、MDN ドキュメントの上位 5 件
  • 結果は1時間キャッシュされます

search_github

リポジトリとコード例の両方については GitHub を検索してください。

  • パラメータ:
    • query (必須): 検索クエリ文字列
    • language (オプション): プログラミング言語でフィルタリング
    • limit (オプション):カテゴリごとの最大結果数(1~10、デフォルト:5)
  • 戻り値: 2 つのセクション:
    1. 星の数でソートされたトップリポジトリ
    2. リポジトリコンテキストを持つ関連コードファイル
  • 結果は1時間キャッシュされます

search_npm

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

  • パラメータ:
    • 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経由で Claude Desktop 用の Code Research Server を自動的にインストールするには:

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
  1. サーバーを構築します。
npm run build
  1. MCP 設定を構成します。

MCP 設定ファイルにサーバー構成を追加します。

  • VSCode: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
  • クロードデスクトップ:
    • 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

検査官は以下を提供します:

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

デバッグ インターフェイスにアクセスするには、ブラウザで指定された URL にアクセスします。

キャッシング

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

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

貢献

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

ライセンス

AGPLv3

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Stack Overflow、MDN、GitHub、npm、PyPI などのプラットフォーム間でのプログラミング リソースの検索とアクセスを容易にし、LLM がコード例やドキュメントを見つけやすくします。

  1. Features
    1. Integrated Platforms
    2. Tools
  2. Requirements
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Development
      1. Running in Development Mode
      2. Error Handling
      3. Debugging
      4. Caching
    3. Contributing
      1. License
        ID: 8ibodeufsz