Politwit1984 Second Opinion MCP Server

🚀 第二意見 MCP サーバー

このサーバーは、複数の人工知能を組み合わせたコーディング問題解決サーバーです。以下の機能を備えています。

• Google Gemini AI の洞察
• Stack Overflow コミュニティの解答
• Perplexity AI の分析能力

✨ 主な機能

• 詳細なプログラミング問題の解決策を提供し、複数のコンテキスト情報を統合します。
• ファイルの拡張子に基づいて自動的にプログラミング言語を識別します。
• コードスニペットをスマートに抽出し、整形します。
• 構造化された Markdown 形式の解決策レポートを自動生成します。
• プロジェクトファイルの Git 依存関係とコンテキストを分析します。

📦 インストール

1. 依存関係のインストール：npm install コマンドを実行して、必要なすべてのパッケージをインストールします。
2. サーバーのビルド：npm run build を使用して、MCP サーバーをビルドします。
3. 環境変数の設定：
   • 設定ファイルのパス：src/config.ts

   export const API_KEYS = {
     GEMINI_API_KEY: 'your_api_key_here',
     PERPLEXITY_API_KEY: 'your_api_key_here',
     STACK_OVERFLOW_API_KEY: 'your_api_key_or_empty' // オプション、デフォルトは匿名アクセス
   };
   

💻 使用例

基本的な使用法

get_second_opinion ツールを呼び出して問題を解決します。入力形式は以下の通りです。

{
  "goal": "目標の説明",
  "error": "エラーメッセージ",
  "code": "関連するコード",
  "solutionsTried": "試した解決策の配列",
  "filePath": "ファイルのパス"
}

高度な使用法

例：React の useEffect のクリーンアップ問題を解決する

{
  "goal": "React の useEffect の cleanup メソッドによるエラーを修正する",
  "error": "TypeError: Cannot read property 'state' of undefined",
  "code": "const [count, setCount] = useState(0);\nuseEffect(() => {\n  const interval = setInterval(() => {\n    setCount(prev => prev + 1);\n  }, 1000);\n  return () => clearInterval(interval);\n}, []);",
  "solutionsTried": ["cleanup 関数を削除する", "effect 内で undefined チェックを行う"],
  "filePath": "src/components/Timer.tsx"
}

解決策の例

基本的な問題分析

エラーメッセージは、setCount がクリーンアップ段階で正しくバインドされていない可能性があることを示しています。useRef と useCallback を使用することで、このような問題を解決できます。

解決策 1：useRef を使用してクリーンアップ関数を保存する

import React, { useEffect, useState, useRef } from 'react';

export default function Timer() {
  const [count, setCount] = useState(0);
  const cleanupRef = useRef<NodeJS.Timeout>();

  useEffect(() => {
    cleanupRef.current = setInterval(() => {
      setCount(prev => prev + 1);
    }, 1000);

    return () => {
      if (cleanupRef.current) {
        clearInterval(cleanupRef.current);
        cleanupRef.current = undefined;
      }
    };
  }, []);

  return <div>現在のカウント: {count}</div>;
}

解決策 2：useCallback を使用して状態を処理する

import React, { useEffect, useState, useCallback } from 'react';

export default function Timer() {
  const [count, setCount] = useState(0);
  const callback = useCallback((prev: number) => prev + 1, []);

  useEffect(() => {
    const interval = setInterval(callback, 1000);
    return () => clearInterval(interval);
  }, [callback]);

  return <div>現在のカウント: {count}</div>;
}

📚 ドキュメント

ベストプラクティス

• 依存関係の管理：useRef を使用して状態を維持し、不要な再レンダリングを避けます。
• パフォーマンスの最適化：useMemo と useCallback を適切に使用して、計算結果をキャッシュします。
• エラーハンドリング：WebSocket や非同期操作では、十分なエラー捕捉と処理ロジックを追加します。
• テストの考慮：主要な機能をカバーする単体テストを作成し、サードパーティの API 呼び出しをモックします。

プロジェクト構造

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 ファイルを参照してください。