Politwit1984 Second Opinion MCP Server

🚀 第二意見 MCP 服務器

第二意見 MCP 服務器是一個結合了多源人工智能輔助的編碼問題解答服務器。它集成了谷歌 Gemini AI 的洞察、Stack Overflow 社區的解答以及 Perplexity AI 的分析能力，能為編程問題提供全面且詳細的解決方案。

🚀 快速開始

第二意見 MCP 服務器整合了多方資源，為編程問題提供詳細解決方案。它能根據文件擴展名自動識別編程語言，智能提取並格式化代碼片段，還能自動生成結構化的 Markdown 解決方案報告，同時分析項目文件的 Git 依賴關係和上下文。

✨ 主要特性

• 提供詳細的編程問題解決方案，整合多方上下文信息。
• 根據文件擴展名自動識別編程語言。
• 智能提取並格式化代碼片段。
• 自動生成結構化的 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 在 cleanup 階段可能未正確綁定。通過使用 useRef 和 useCallback 可以有效解決此類問題。

提供的解決方案

方案一：使用 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>;
}

方案二：使用 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 或異步操作中添加充分的錯誤捕捉和處理邏輯。
• 測試考慮：編寫單元測試覆蓋主要功能，並 mocking 第三方 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 文件。