在 Docker 容器中配置 MCP Server 环境变量，最推荐通过 `docker run -e` 命令或 `docker-compose.yml` 的 `environment` 字段注入，适用于 Slack、Context7 等各类 MCP 服务部署。风险边界在于切勿将敏感密钥硬编码在 Dockerfile 或代码仓库中，应使用 `.env` 文件配合密钥管理工具。

命令速用版

直接使用 `docker run` 命令注入单个变量，适用于快速测试：

docker run -e DB_HOST=localhost -e LOG_LEVEL=debug -e API_KEY=abc123 mcp-server:latest

生产环境建议使用 `docker-compose.yml` 管理多变量：

version: '3'
services:
  mcp-server:
    image: mcp-server:latest
    environment:
      - DB_HOST=postgresql://user:pass@db:5432/appdb
      - LOG_LEVEL=warn
    env_file:
      - .env

为什么会这样

环境变量机制允许服务在启动时动态读取配置，无需重新编译代码。在 MCP 架构中，这用于控制日志级别、连接地址、功能开关等关键参数，实现配置与镜像解耦。通过外部化配置，服务能够在不同部署环境（如开发、测试、生产）中动态调整行为，同时避免敏感信息如密码或令牌泄露至版本控制系统。

分步处理

第一步：准备环境变量文件。在项目根目录创建 `.env` 文件，复制模板 `.env.example` 或 `.env.dist` 并修改必要配置。例如 Slack MCP Server 需配置 `SLACK_MCP_XOXC_TOKEN` 和 `SLACK_MCP_XOXD_TOKEN`。

第二步：编写或修改编排文件。在 `docker-compose.yml` 的 `environment` 字段列出变量，或通过 `env_file` 指定 `.env` 路径。若使用 Python 编写的 MCP Server，代码中应通过 `os.getenv` 接口读取。

第三步：启动服务。执行 `docker-compose up -d` 或 `docker run` 命令。若涉及配置文件动态替换，可设置 `REPLACE_ENV_IN_PLACE=true` 并定义前缀如 `CFG_`，启动脚本会自动遍历容器内文件替换变量。

怎么验证是否生效

查看容器日志确认配置加载情况，使用命令 `docker logs <容器名称>`。检查服务是否成功连接数据库或外部 API，例如观察日志中是否有 `DB_HOST` 连接成功的提示。对于需要特定令牌的服务，验证交互界面是否正常显示或 API 调用是否返回授权错误。

常见坑

敏感信息硬编码风险：切勿将密码或 Token 直接写在 Dockerfile 或提交到 Git 仓库，推荐结合密钥管理工具动态注入。变量前缀限制：部分镜像仅识别特定前缀的环境变量（如 `CFG_`），未加前缀可能导致替换失效。必需参数缺失：启动前需确认所有必需变量（如 EULA 同意协议）已设置，否则服务可能拒绝启动。

常见问题

修改环境变量后需要重建镜像吗？

不需要。环境变量在容器启动时注入，修改 `.env` 文件后重启容器即可生效，无需重新构建镜像。

如何安全存储高敏感密钥？

避免使用明文 `.env` 文件，推荐应用启动前从安全存储（如 Hashicorp Vault）拉取凭证，通过操作系统环境变量传递给进程。

为什么代码读不到环境变量？

检查变量名是否拼写一致，确认容器启动命令中已包含 `-e` 参数或 `environment` 配置，且变量未被宿主机的 shell 提前解析。

参考来源

• CSDN 博客：揭秘 MCP Server 环境变量配置:3 步完成 API KEY 安全管理
• GitCode：Docker 部署 Slack MCP Server 完全指南：快速上手容器化方案
• GitCode：Docker 部署 MCP Server 完整教程：容器化 Claude 工具服务 (含 docker-compose 生产配置)
• GitCode：7 个实用技巧：用 docker-minecraft-server 环境变量动态改造配置文件的终极指南
• GitCode：MCP 应用 docker 部署，docker-compose 部署