Second Opinion MCP Server

🚀 第二意見MCPサーバー

第二意見MCP（マルチポイントコンサルティングプロトコル）サーバーは、複数のAIツールを組み合わせて、プログラミング問題の解決策を提供するシステムです。Gemini AI、Perplexity AI、Stack Overflow APIを統合することで、ユーザーに包括的な技術サポートを提供します。

🚀 クイックスタート

第二意見MCPサーバーは、複数のAIツールを活用して、プログラミング問題に対する解決策を提供します。以下の手順でサーバーをセットアップし、利用を開始できます。

✨ 主な機能

1. 自動言語検出：コードスニペットの言語を識別します。
2. コードスニペットの抽出と整形：ファイルからコードを抽出し、整形処理を行います。
3. AIコンサルティングの統合：
   • Gemini AI：コード分析と改善提案を提供します。
   • Perplexity AI：プログラミング問題に対する解答を提供します。
4. Stack Overflowの統合：関連する解決策を自動的に検索します。

📦 インストール

依存関係のインストール

npm install express uuid @types/node typescript ts-node

サーバーのビルド

npm run build

環境変数の設定

config.tsを編集します：

export const config = {
  GEMINI_API_KEY: 'your_api_key',
  PERPLEXITY_API_KEY: 'your_api_key',
  STACK_OVERFLOW_API_KEY: 'your_api_key'
};

💻 使用例

基本的な使用法

主なツールはget_second_opinionで、HTTP POSTリクエストを使用してプログラミング問題を送信します。

入力例

{
  "problem": "如何在TypeScript中实现WebSocket连接？",
  "context": {
    "codeSnippet": "const socket = new WebSocket('ws://localhost:8080');"
  }
}

出力例

{
  "解决方案": [
    {
      "方法": "使用useRef管理WebSocket实例",
      "代码示例": "const socketRef = useRef<WebSocket | null>(null);"
    },
    {
      "方法": "生命周期管理",
      "代码示例": "useEffect(() => { // WebSocket连接逻辑 }, []);"
    }
  ],
  "最佳实践": [
    "使用useCallback处理事件监听",
    "确保优雅关闭连接"
  ]
}

🔧 技術詳細

問題の理解

TypeScriptでWebSocket接続を実装する際には、以下の点を考慮する必要があります。

• 接続管理：接続を正しく開き、維持し、閉じる方法。
• 状態管理：異なるWebSocket接続状態（Connecting, Open, Closing, Closed）を処理する方法。
• メッセージ処理：受信したメッセージを解析し、コンポーネントの状態を更新する方法。

解決策

方法1：useRefを使用したインスタンス管理

function useSocket(url: string) {
  const socketRef = useRef<WebSocket | null>(null);

  useEffect(() => {
    socketRef.current = new WebSocket(url);
    
    return () => {
      if (socketRef.current) {
        socketRef.current.close();
      }
    };
  }, [url]);

  const sendMessage = useCallback((message: string) => {
    if (socketRef.current?.readyState === WebSocket.OPEN) {
      socketRef.current.send(message);
    }
  }, []);

  return { sendMessage };
}

方法2：接続ライフサイクルの処理

function useWebSocket(url: string) {
  const [messages, setMessages] = useState<string[]>([]);

  useEffect(() => {
    const socket = new WebSocket(url);

    socket.onmessage = (event: MessageEvent) => {
      setMessages(prev => [...prev, event.data]);
    };

    return () => {
      socket.close();
    };
  }, [url]);

  const sendMessage = useCallback((message: string) => {
    if (socket.readyState === WebSocket.OPEN) {
      socket.send(message);
    }
  }, []);

  return { messages, sendMessage };
}

📚 ドキュメント

ベストプラクティス

1. 依存関係の管理：
   • useRefを使用して状態を維持します。
   • useCallbackを使用してパフォーマンスを最適化します。
2. パフォーマンス最適化：不要な再レンダリングを避けるために、Reactフックを適切に使用します。
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の型定義ファイル

注意事項

⚠️ 重要提示

• エラー処理：すべてのネットワーク操作に十分なエラー捕捉と処理メカニズムを追加してください。
• パフォーマンス最適化：Reactフックを適切に使用して、不要な再レンダリングを避けてください。
• コードスタイル：Prettierなどの統一されたコード規約に従ってください。

以上の方法と技術を使用することで、第二意見MCPサーバーは開発者が複雑なプログラミング問題を解決するのに効果的に役立ちます。