WSL 安装 MCP 并配置 Codex 的完整流程

安装 MCP Playwright
在 WSL 中执行全局安装命令:

npm install -g @playwright/mcp

验证安装是否成功:

npx @playwright/mcp@latest --help

配置 Codex 的 MCP 服务

编辑配置文件

nano ~/.codex/config.toml

添加以下内容:

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@latest"]
startup_timeout_sec = 60

关键配置说明:

  • -y 参数用于跳过 npx 的确认提示
  • startup_timeout_sec 必须设置为 60 秒以避免超时

预运行测试

手动执行一次命令以预下载依赖:
npx -y @playwright/mcp@latest --help

验证配置

重启 Codex 后输入 /mcp 命令,确认列表中显示 playwright 即表示配置成功。

常见问题处理

性能问题根源:

  • WSL 环境下 npx 安装依赖及文件 IO 速度较慢
  • 必须使用 -y 参数避免交互式卡死
  • 超时设置必须调整为 60 秒

最终建议:
直接采用 60 秒超时配置,避免反复调试耗时。

Logo

火山引擎开发者社区是火山引擎打造的AI技术生态平台,聚焦Agent与大模型开发,提供豆包系列模型(图像/视频/视觉)、智能分析与会话工具,并配套评测集、动手实验室及行业案例库。社区通过技术沙龙、挑战赛等活动促进开发者成长,新用户可领50万Tokens权益,助力构建智能应用。

更多推荐