Docs 菜单
Docs 主页
/ /

MongoDB MCP Server 进行故障排除

使用此页面上的信息可帮助解决MongoDB MCP 服务器的问题。

如果 MCP 服务器出现问题,请检查 MCP 服务器日志以获取有助于解决问题的信息。

默认下,MCP 服务器将日志写入磁盘,并将日志发送到 MCP客户端。您可以更改 loggers 选项以指定日志发送位置。有关 MCP 服务器选项的详细信息,请参阅 MongoDB MCP 服务器配置选项。

下表显示了 MCP 服务器存储日志文件的默认目录:

操作系统
默认日志目录

Windows

%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs

macOS 和 Linux

~/.mongodb/mongodb-mcp/.app-logs

要更改日志路径,设立以下选项之一:

  • logPath JSON配置文件中或启动 MCP 服务器时命令行上的选项

  • MDB_MCP_LOG_PATH 环境变量

确保您的配置文件正确,并且您为MongoDB 部署使用有效的连接字符串。

有关连接字符串格式和示例,请参阅 连接字符串。

如果您使用HTTP传输并遇到连接问题:

  • 验证您的客户端连接URL是否包含 /mcp 端点路径:

    http://<server-address>:3000/mcp
  • 如果连接到远程服务器(不同的计算机、容器或云实例),请确保使用 --httpHost=0.0.0.0 启动服务器以接受远程连接:

    npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --readOnly
  • 确保指定端口已打开并可从客户端计算机访问。

后退

独立服务

在此页面上