6.9. 调试常见问题

当您 MCP 服务器未列出或无法执行时，诊断并解决初始化失败。通过系统地验证构建日志、安装的文件和清单，您可以识别部署错误的根本原因，并成功运行您的服务器。

流程

检查构建日志。在构建输出的 ansible-playbook 步骤中查找错误。常见问题包括软件包下载过程中缺少依赖项或网络访问失败。
检查安装的文件并验证是否存在二进制或脚本：
podman run --rm my-cfn-mcp-ee:latest ls -la /opt/mcp/bin/
检查清单，独立于二进制文件。如果 mcp_manage 列表显示服务器，但 mcp_manage 运行失败，则生成清单，但软件包安装可能静默失败。
直接运行服务器。绕过 mcp_manage 并直接调用服务器二进制文件来查看原始错误输出：
podman run --rm my-cfn-mcp-ee:latest /opt/mcp/bin/awslabs.cfn-mcp-server --help