Code Research MCP Server

🚀 コード研究 MCP サーバ

このサーバは、Model Context Protocol（モデルコンテキストプロトコル）に基づき、様々なプログラミングリソースの検索とアクセスを提供します。複数の人気開発者プラットフォームを統合し、大規模言語モデル（LLMs）が関連するコード例、ドキュメント、パッケージを見つけるのを支援します。

🚀 クイックスタート

この Model Context Protocol サーバは、複数の開発者プラットフォームを統合し、大規模言語モデルが関連するコード例やドキュメントを見つけるのを支援します。以下のセクションでは、その機能、インストール方法、開発に関する情報を提供します。

✨ 主な機能

統合プラットフォーム

• Stack Overflow - プログラミングの質問と回答のコミュニティ
• 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（必須）：検索クエリ文字列
  • limit（オプション）：最大結果数（1 - 10、デフォルト：5）
• 戻り値：リポジトリ名、説明、スター数を含むリスト
• 結果のキャッシュ時間は 1 時間です

search_npm

npm 上で JavaScript パッケージを検索します。

• パラメータ：
  • query（必須）：検索クエリ文字列
  • limit（オプション）：最大結果数（1 - 10、デフォルト：5）
• 戻り値：パッケージ名、バージョン、説明を含むリスト
• 結果のキャッシュ時間は 1 時間です

search_pypi

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

• パラメータ：
  • query（必須）：検索クエリ文字列
  • limit（オプション）：最大結果数（1 - 10、デフォルト：5）
• 戻り値：パッケージ名、バージョン、説明を含むリスト
• 結果のキャッシュ時間は 1 時間です

📦 インストール

Smithery を使用したインストール

npx smithery install @nahmanmate/code-research-mcp-server

手動インストール

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/code-research-mcp-server.git
   cd code-research-mcp-server
   

2. 依存関係をインストールします：

   npm install
   

3. サーバを起動します：

   node index.js
   

MCP 設定の構成

package.json に以下の設定を追加します：

{
  "mcp": {
    "servers": {
      "code-research-mcp-server": {
        "command": "node index.js",
        "type": "stdio"
      }
    }
  }
}

📚 ドキュメント

開発モードでの実行

自動再構築機能付きで実行します：

npm run watch

エラー処理

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

• 各プラットフォームの API 固有のエラーメッセージ
• GitHub API のレート制限処理
• サービスが利用不可の場合のグレースフルデグレード
• API 負荷を軽減するためのキャッシュ応答

デバッグ

MCP サーバは標準入力/出力を介して通信するため、デバッグは難しいです。MCP インスペクターを使用して詳細なリクエスト/レスポンス監視を行います：

npm run inspector

インスペクターは以下を提供します：

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

ブラウザで提供される URL にアクセスしてデバッグ画面を取得します。

キャッシュ

node-cache を使用してキャッシュを行います：

• デフォルト TTL：1 時間
• 各クエリ/制限の組み合わせに独立したキャッシュキー
• プラットフォーム固有のキャッシュポリシー
• メモリ効率の良いストレージ

🔧 貢献方法

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

📄 ライセンス

AGPLv3