Graphiti项目中的MCP服务超时问题分析与解决方案

问题背景

在使用Graphiti项目的MCP(Memory Context Provider)服务时，用户报告了一个频繁出现的超时问题。具体表现为在Docker容器环境下运行MCP服务时，首次添加短篇幅内容(约100个token)可以成功，但后续所有添加操作都会因超时而失败，即使内容更短也会出现同样问题。

问题现象

从日志中可以观察到以下关键信息：

1. 首次添加操作能够正常完成
2. 后续操作在60秒后超时(2025-05-20T13:33:38.597Z开始，2025-05-20T13:34:38.599Z超时)
3. 错误代码为MCP error -32001: Request timed out
4. MCP容器本身没有记录相关错误日志

技术分析

这个问题本质上是一个连接复用和并发处理的问题。MCP服务使用SSE(Server-Sent Events)作为传输协议，当第一个添加操作尚未完成时，后续请求尝试复用同一个连接，导致冲突和超时。

具体表现为：

1. 首次请求建立了一个SSE连接
2. 该连接在处理过程中被后续请求尝试复用
3. 由于连接已被占用，后续请求无法获得响应
4. 最终达到预设的超时时间(120秒)后失败

解决方案

针对这个问题，开发团队已经提出了修复方案，主要包含以下改进：

1. 连接隔离：确保每个上传请求使用独立的SSE端点，避免连接复用冲突
2. 并行处理优化：通过增加Uvicorn工作线程数量，支持真正的并行上传
3. 连接状态管理：改进连接状态检测机制，防止"connection in use"错误

实施建议

对于遇到此问题的用户，建议采取以下步骤：

1. 更新到Graphiti项目的最新main分支代码
2. 检查Docker配置，确保资源分配合理(特别是内存设置)
3. 在librechat.yml配置中适当调整超时参数
4. 考虑增加Uvicorn工作线程数量以支持并行处理

总结

Graphiti项目的MCP服务超时问题是一个典型的连接管理和并发处理问题。通过更新到最新代码版本并合理配置服务参数，可以有效解决这个问题。对于需要高频添加内容的场景，建议特别关注并行处理能力的配置优化。