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. 性能優化：減少不必要的重新渲染。
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類型定義文件

🔧 技術細節

第二意見MCP服務器通過集成多個AI工具和Stack Overflow API，為開發者提供了一個強大的編程問題解決平臺。它利用自動語言檢測和代碼格式化功能，提高了問題處理的效率。同時，通過合理使用React鉤子和優化性能，確保了系統的穩定性和響應速度。

📄 注意事項

⚠️ 重要提示

• 確保在所有網絡操作中加入充分的錯誤捕捉和處理機制。
• 合理使用React鉤子，避免不必要的重新渲染。
• 遵循統一的代碼規範，如使用Prettier進行代碼格式化。

通過以上方法和技術，第二意見MCP服務器能夠有效地幫助開發者解決複雜的編程問題。