Nahmanmate Code Research MCP Server

🚀 コード研究 MCP サーバ

このサーバは、複数のプラットフォームのプログラミングリソースを検索およびアクセスできるモデルコンテキストプロトコル (Model Context Protocol) サーバです。人気のある開発者プラットフォームを統合し、大規模言語モデル（LLM）が関連するコード例、ドキュメント、パッケージを検索するのを支援します。

🚀 クイックスタート

このコード研究 MCP サーバは、複数のプラットフォームのプログラミングリソースを検索およびアクセスするための便利なツールです。以下の手順でサーバを利用できます。

✨ 主な機能

統合プラットフォーム

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

ツール

search_stackoverflow

Stack Overflow 上のプログラミングの質問と回答を検索します。

• パラメータ：
  • query（必須）：検索クエリ文字列
  • limit（オプション）：最大結果数（1 - 10、デフォルト値：5）
• 戻り値：評価、回答数、抜粋を含む形式の質問リスト
• 結果のキャッシュ時間は 1 時間です

search_mdn

MDN Web ドキュメントを検索します。

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

search_github

GitHub 上のコードリポジトリまたはコンテンツを検索します。

• パラメータ：
  • query（必須）：検索クエリ文字列
  • language（オプション）：指定するプログラミング言語
  • limit（オプション）：最大結果数（1 - 10、デフォルト値：5）
• 戻り値：リポジトリ名、説明、関連するコードスニペットを含むリスト
• 結果のキャッシュ時間は 1 時間です

search_npm

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

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

search_pypi

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

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

search_all

すべてのプラットフォームを同時に検索します。

• パラメータ：
  • query（必須）：検索クエリ文字列
  • limit（オプション）：各プラットフォームの最大結果数（1 - 10、デフォルト値：5）
• 戻り値：すべてのプラットフォームからの総合結果リストで、関連性でソートされます
• 結果のキャッシュ時間は 1 時間です

📦 インストール

自動インストール (Smithery を通じて)

npm install -g @nahmanmate/code-research-mcp-server

手動インストール

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

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

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

   npm install
   

📚 ドキュメント

設定

package.json でデフォルトパラメータを設定します。例えば：

{
  "github.token": "your_github_token",
  "npm.email": "your_npm_email",
  "pypi.endpoint": "https://pypi.org/pypi"
}

開発

開発モードで実行

変更を自動的に再構築する機能付きです：

npm run dev

エラー処理

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

• 各プラットフォームの特定のエラーメッセージ
• GitHub API のレート制限処理
• サービスが利用できない場合のエレガントなフォールバック
• API 負荷を減らすためのキャッシュ応答

デバッグ

MCP サーバは stdio 通信を使用するため、デバッグは難しいです。MCP Inspector を使用して詳細なリクエスト/レスポンスを監視します：

npm run debug

Inspector は以下を提供します：

• リアルタイムのリクエスト/レスポンス監視
• ツール実行トレース
• エラースタックトレース
• パフォーマンス指標 提供された URL をブラウザで開いてデバッグ画面にアクセスします。

キャッシュ

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

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

🔧 貢献方法

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

📄 ライセンス

AGPLv3