Second Opinion (Code Assistant)

🚀 第二意見 MCP 服務器

這是一個融合了多種 AI 技術的 MCP 服務器，專門用於解答編程問題。它整合了谷歌 Gemini AI 的洞察、Stack Overflow 的最佳實踐答案以及 Perplexity AI 的分析結果，為用戶提供更全面、準確的解決方案。

🚀 快速開始

安裝配置

1. 創建配置文件：在項目根目錄下新建 config.ts 文件，內容如下：

export const CONFIG = {
  AI_API_KEY: 'your_api_key_here', // 替換為你的 API 密鑰
  STACK_OVERFLOW_API_KEY: 'your_stack_overflow_key_here' // 替換為你的 Stack Overflow API 密鑰
};

2. 安裝依賴項：使用 npm 或 yarn 安裝所需包：

npm install @types/node @types/express express axios

3. 啟動服務器：執行以下命令啟動 MCP 服務器：

node index.ts

使用說明

功能概述

該服務器提供以下核心功能：

1. 多源解答：整合 Gemini AI、Stack Overflow 和 Perplexity AI 的結果，生成更全面的解決方案。
2. 語言檢測：自動識別文件語言並提供相應支持（如 JavaScript、Python 等）。
3. 代碼處理：提取和格式化代碼片段，便於展示和分析。

請求示例

示例輸入

{
  "query": "如何在 Node.js 中實現異步通信",
  "file_path": "src/server.ts"
}

示例輸出

## 解決方案概述

針對問題 "如何在 Node.js 中實現異步通信"，以下是分步驟的解決方案：

### 步驟 1: 使用內置模塊 `async` 或 `await`
Node.js 提供了強大的 async/await 特性來處理異步操作。你可以直接使用這些特性來實現異步通信。

#### 示例代碼
```javascript
const fs = require('fs');

// 異步讀取文件內容
async function readFileAsync(filePath) {
  try {
    const data = await fs.promises.readFile(filePath, 'utf8');
    console.log(data);
  } catch (error) {
    console.error('讀取文件失敗:', error);
  }
}

readFileAsync('src/server.ts');

步驟 2: 利用第三方庫進行高級異步處理

如果需要更復雜的異步操作，可以考慮使用 rxjs 或 bluebird 等第三方庫。

示例代碼

const { Observable } = require('rxjs');

// 使用 RxJS 實現異步通信
Observable.fromEventPattern(document, 'click')
  .subscribe(() => {
    console.log('頁面被點擊了');
  });

最佳實踐

1. 錯誤處理：始終在 async 函數內部使用 try-catch 塊。
2. 日誌記錄：建議集成專業的日誌系統（如 Winston）以更好地追蹤異步操作。
3. 性能優化：避免不必要的嵌套，保持代碼簡潔。

## ✨ 主要特性
- 提供詳細的問題解決方案，結合多源上下文信息
- 自動檢測文件語言（通過文件擴展名）
- 代碼片段提取與格式化
- 自動生成 Markdown 格式的解決方案報告
- Git 感知的文件上下文收集

## 📚 詳細文檔
### 項目結構

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](./errors.md) 查看當前已知的問題和解決方案。

> ⚠️ **重要提示**
> 
> 使用該服務器前，請確保已經正確配置了所有必要的 API 密鑰，並且網絡環境允許訪問相關 AI 服務。