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服务器能够有效地帮助开发者解决复杂的编程问题。