Second Opinion MCP Server

🚀 第二意见 MCP サーバー

様々なAIサービスを統合し、プログラミング問題の解答を提供するMCPサーバーです。以下の機能を備えています。

• GoogleのGemini AI：強力なコード理解と提案を提供します。
• Stack Overflowの承認済み回答：コミュニティで検証された解決策を取得します。
• Perplexity AI分析：コンテキスト理解と問題特定を強化します。

✨ 主な機能

• 詳細な解決策：多段階の解答と説明を提供します。
• 自動言語検出：複数のプログラミング言語の識別と処理をサポートします。
• コードスニペットの抽出と整形：コードスニペットを自動的に抽出し、整形します。
• Markdownレポート生成：構造化された分析レポートを出力します。
• Git感知ファイルコンテキスト収集：Gitリポジトリに基づいてコンテキスト情報を提供します。

📦 インストール

依存関係のインストール

npm install

サーバーのビルド

npm run build

環境変数の設定

config.ts ファイルを編集し、以下の内容を追加します。

export const API_KEY = 'your_api_key';
export const LOG_PATH = './logs/';

💻 使用例

核心ツール：get_second_opinion

このツールは、問題の説明とコンテキストを含むJSONオブジェクトを受け取り、詳細な解答レポートを返します。

入力形式

{
  "problem": "WebSocketサーバーに接続できません",
  "context": {
    "code片段": "...",
    "依赖项": ["ws", "express"],
    "环境": "Docker"
  }
}

基本的な使用法

curl -X POST http://localhost:3000/second-opinion \
  -H "Content-Type: application/json" \
  -d '{"problem":"无法连接到 WebSocket 服务器","context":{"code片段":"const socket = new WebSocket('ws://example.com');", "依赖项":["ws","express"],"环境":"Docker"}}'

解決策の例

問題の理解

ユーザーは、Docker環境で ws ライブラリを使用してWebSocketサーバーに接続できないと報告しています。

考えられる原因の分析

1. コンテナネットワーク設定：WebSocket接続がコンテナネットワークポリシーによって制限されている可能性があります。
2. プロトコルサポート：WebSocketが有効になっているか、ポートが正しくマッピングされているかを確認してください。
3. 依存関係のバージョンの競合：ws と express のバージョンが互換性がない可能性があります。

解決策

// 最適化されたWebSocket接続設定
const socket = new WebSocket('ws://localhost:8080', {
  headers: {
    'Authorization': 'Bearer your_token'
  }
});

socket.onopen = () => {
  console.log('接続が確立されました');
};

socket.onclose = (event) => {
  console.log(`接続が閉じられました。ステータスコード: ${event.code}`);
};

ベストプラクティス

1. 依存関係の管理：
   • useRef を使用してWebSocket接続を維持します。
   • useCallback を使用してメモ化したメッセージコールバック関数を処理します。
   • WebSocketのライフサイクルを適切に管理します。
2. パフォーマンスの最適化：
   • 不要な再レンダリングを減らします。
   • メッセージ処理ロジックを最適化し、高負荷を避けます。
   • 適切なクリーンアップパターンを使用します。
3. エラー処理：
   • 接続エラーをキャッチし、ログに記録します。
   • 自動再接続機能を実装します（オプション）。
   • リソースが適切にクリーンアップされることを確認します。
4. テストの考慮事項：
   • テストでWebSocket接続をシミュレートします。
   • イベントリスナーが正しくクリーンアップされることを検証します。
   • さまざまなエラーシナリオでの応答をテストします。

📚 ドキュメント

プロジェクト構造

src/
├── config.ts        # 設定ファイルとAPI設定
├── fileUtils.ts     # ファイル操作と言語検出機能
├── index.ts         # エントリポイント、サーバーの起動
├── perplexity.ts   # Perplexity AIの統合実装
├── server.ts       # MCPサーバーのメイン実装
├── stackOverflow.ts # Stack Overflow APIの呼び出しインターフェース
└── types.ts        # TypeScriptの型定義

既知の問題

詳細な情報は errors.md ファイルを参照してください。