[BUG]: GitLab MCP shown as not running through mcp-remote, but agent tool calls work

该报错通常出现在把旧版自建 GitLab 的 MCP 端点通过 mcp-remote 接入 AnythingLLM 的场景:GitLab 对 ping 返回 -32601 Method not found ,被 mcp-remote 转成 -32001 ,导致 Agent Skills 里显示为 n

快速结论:该报错通常出现在把旧版自建 GitLab 的 MCP 端点通过 mcp-remote 接入 AnythingLLM 的场景:GitLab 对 ping 返回 -32601 Method not found,被 mcp-remote 转成 -32001,导致 Agent Skills 里显示为 not running,但工具调用实际可用。

适用环境:AnythingLLM 1.19.0 Docker(本地);MCP 服务经 mcp-remote(基于 node@22)以 stdio 方式接入 AnythingLLM,并由其以 Streamable HTTP 访问自建 GitLab,且已完成 OAuth;GitLab 版本低于 19.6。

最快修复方案:把自建 GitLab 升级到 19.6 或更高版本,该版本支持 ping,服务器状态会正常显示为 running。

注意事项:在升级前服务状态显示不可信,但工具可正常使用,可直接忽略该状态;Issue 维护者明确不会把 -32001 当作健康状态处理,因为该错误码按规范也用于真实的超时和会话中断,读取内部错误文本来判定会掩盖真实故障。若升级 GitLab 后仍显示 not running,则属于其他问题,需另行排查。

问题场景

在 Docker 本地运行的 AnythingLLM 1.19.0 中,通过 mcp-remote(stdio 本地,Streamable HTTP 到自建 GitLab)配置 GitLab MCP 服务并完成 OAuth,配置写入 /app/server/storage/plugins/anythingllm_mcp_servers.json。刷新 Agent Skills 后,该服务器显示为 not running;但在新的 agent 对话中调用其工具(如 get_mcp_server_version)可以成功返回结果。

报错原文

AnythingLLM reports `-32001`. The underlying GitLab JSON-RPC response is `-32601 Method not found` for `ping`.
[BUG]: GitLab MCP shown as not running through mcp-remote, but agent tool calls work

原因分析

根因在旧版 GitLab 与 mcp-remote 的交互方式,而非 AnythingLLM 本身(据 Issue 讨论):

  • GitLab 的 MCP 端点在 19.6 才加入 ping 支持。更早版本会以 JSON-RPC 的 -32601 Method not found 回应 ping,但携带的是 HTTP 404 状态码,而不是正常的 200 响应。
  • mcp-remote 把这个 404 当作连接失败而非 JSON-RPC 回复,于是向 AnythingLLM 发送自己的 -32001 错误,原始的 -32601 只保留在错误文本里,造成混淆。
  • 自 #6805(随 1.19.0 发布)起,AnythingLLM 会把对 ping 的 -32601 回复视为“服务器在运行”。但在本场景中该错误码被 mcp-remote 替换为 -32001,无法到达 AnythingLLM,因此状态判定失效。
  • 工具调用仍然正常,是因为服务器启动并不依赖 ping,受影响的只是 Agent Skills 中的 running 状态显示。

环境排查

  • 确认 AnythingLLM 版本:Issue 中为 1.19.0 Docker;该版本已包含 #6805 的 -32601 处理逻辑。
  • 确认自建 GitLab 版本:若低于 19.6,则 MCP 端点不支持 ping,与本报错特征吻合。
  • 确认 MCP 接入链路是否为 mcp-remote(node@22),以及 anythingllm_mcp_servers.json 中的 command/args 配置。
  • 确认 OAuth 已成功完成,且 Agent 对话中能实际调用该服务器工具。

解决步骤

  1. 检查自建 GitLab 版本,确认是否低于 19.6。
  2. 将 GitLab 升级到 19.6 或更高版本,使 MCP 端点支持 ping。
  3. 升级后在 AnythingLLM 中刷新 Agent Skills,重新查看该 MCP 服务的运行状态。
  4. (临时措施)如暂时无法升级,可在确认工具调用正常的前提下忽略该 not running 状态,无需改动 AnythingLLM 侧配置。

验证方法

升级 GitLab 后刷新 Agent Skills,确认 GitLab MCP 服务器显示为 running;同时再次在 agent 对话中调用该服务器的工具(如 get_mcp_server_version),确认仍能正常返回结果。若升级后状态仍为 not running,说明存在其他问题,需按新一轮排查处理(Issue 维护者建议此时可重新打开该 Issue)。

参考来源

Mintplex-Labs/anything-llm #7286

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36129

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注