GitHub MCP Server在Roocode中配置SSE错误的解决方案

问题背景

GitHub MCP Server是一个用于管理GitHub相关操作的服务端程序，而Roocode（Void Editor的一个分支）是基于VSCode的代码编辑器。用户在使用过程中遇到了SSE（Server-Sent Events）协议相关的配置问题，具体表现为在设置mcp_settings.json文件后出现"Invalid content type, expected 'text/event-stream'"错误。

技术分析

SSE是一种服务器向客户端推送事件的技术标准，它要求服务器返回的内容类型必须是"text/event-stream"。当客户端收到不符合此内容类型的响应时，就会抛出上述错误。

在GitHub MCP Server的配置中，用户尝试了两种方式：

1. 通过Docker命令直接运行服务
2. 通过本地HTTP服务连接

从技术日志可以看出，虽然直接通过命令行测试Docker容器能够正常工作，但在Roocode环境中却出现了SSE协议不匹配的问题。

解决方案

经过排查，发现这个问题可以通过以下步骤解决：

1. 重启编辑器：在Roocode/Void Editor中通过命令面板（Ctrl+Shift+P）执行"Developer: Reload Window"命令，重新加载编辑器窗口。这个简单的操作往往能解决许多配置不生效的问题。

2. 检查配置格式：确保mcp_settings.json文件格式正确，特别是：

   • JSON语法正确无误
   • 所有引号都是直引号而非弯引号
   • 没有多余的逗号

3. 验证Docker环境：确认Docker服务正常运行，并且有足够的权限访问相关资源。

深入理解

这个问题的本质在于Roocode/Void Editor与GitHub MCP Server之间的通信协议协商失败。SSE协议要求严格的Content-Type头部设置，而某些情况下编辑器可能缓存了旧的配置或连接状态，导致协议协商失败。

重启编辑器实际上是清除了这些潜在的缓存状态，使得新的配置能够正确加载和协商。这也提醒我们，在开发工具链中，配置变更后有时需要重启相关组件才能使变更完全生效。

最佳实践建议

1. 配置变更后重启：修改mcp_settings.json等关键配置文件后，建议重启编辑器以确保变更生效。

2. 分步验证：可以先用简单的curl命令测试SSE端点是否正常工作，再在编辑器中集成。

3. 日志检查：充分利用Docker和编辑器的日志输出功能，帮助诊断问题。

4. 安全注意：如仓库协作者提醒的，注意不要在配置文件中或公开场合暴露个人访问令牌(PAT)，一旦发现泄露应立即撤销。

通过以上分析和解决方案，开发者可以更好地在Roocode/Void Editor环境中配置和使用GitHub MCP Server，避免SSE协议相关的配置问题。