OTerm项目多MCP服务器配置问题分析与解决方案

问题背景

OTerm是一个基于文本界面的AI工具，它允许用户通过配置多个MCP（Model Control Protocol）服务器来扩展功能。近期有用户反馈在配置多个本地MCP服务器时遇到了无法获取响应的问题，本文将深入分析该问题并提供解决方案。

问题现象

用户在Apple M4 Pro平台上使用OTerm v0.8.3和Ollama 0.5.7时，配置了两个本地MCP服务器：

1. 天气服务(weather)：运行在/AIProjects/weather目录下的weather.py
2. 演示服务(Demo)：运行在/AIProjects/planner目录下的server.py

尽管两个服务都能通过Claude Desktop正常工作，但在OTerm中却无法获得任何响应，且日志中没有显示错误信息。

技术分析

可能原因1：uv命令路径问题

从代码贡献者的反馈来看，使用相对路径"uv"可能导致系统无法正确找到可执行文件。这与Unix/Linux系统的PATH环境变量解析机制有关。

解决方案：

• 在配置文件中使用uv的绝对路径
• 例如："/Users/username/.local/bin/uv"而非简单的"uv"

可能原因2：多服务器配置冲突

仓库所有者提到这可能是一个已知的bug（#167），当配置多个MCP服务器时，OTerm可能无法正确处理多个服务器实例。

临时解决方案：

• 先尝试单独配置一个服务器进行测试
• 确认单个服务器能正常工作后再添加第二个

可能原因3：参数配置格式

对比工作配置和非工作配置，发现参数顺序和内容有细微差别：

工作配置示例：

{
  "command": "/Users/sheffler/.local/bin/uv",
  "args": [
    "--directory",
    "/Users/sheffler/src/mcp5",
    "run",
    "--with",
    "mcp",
    "mcp",
    "run",
    "/Users/sheffler/src/mcp5/tom5server.py"
  ]
}

最佳实践建议

1. 使用绝对路径：为所有命令和文件指定完整路径
2. 简化测试：先配置单个服务器确保基本功能正常
3. 参数顺序：严格按照uvicorn/uv的命令行参数要求顺序
4. 日志检查：虽然用户报告日志无错误，但建议检查更详细的日志级别
5. 版本兼容性：确保OTerm、Ollama和MCP服务器版本兼容

配置示例修正

修正后的配置建议：

{
  "theme": "textual-dark",
  "splash-screen": true,
  "mcpServers": {
    "weather": {
      "command": "/full/path/to/uv",
      "args": [
        "--directory",
        "/AIProjects/weather",
        "run",
        "--with",
        "mcp",
        "mcp",
        "run",
        "weather.py"
      ]
    }
  }
}

总结

OTerm的多MCP服务器配置问题可能由多种因素导致，包括路径解析、参数顺序和多实例处理等。用户可按照本文建议逐步排查，特别注意使用绝对路径和正确的参数顺序。对于更复杂的问题，建议关注项目更新，等待官方修复相关bug。