🚀 第二意见 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 文件。