使用说明
剧作家MCP Docker环境
Docker在环境中Playwright MCP运行服务器并允许外部工具进行自动浏览器操作的项目。
🚀 快速启动
# 1. リポジトリをクローン
git clone <repository-url>
cd playwright-replan
# 2. Docker Composeで起動
docker-compose up -d
# 3. 動作確認
curl http://localhost:8931/health
SSE端点： http://localhost:8931/sse
📋 机能
- 无头浏览器操作: Chromium/Firefox/WebKit自动操作
- SSE通信：获取实时浏览器操作结果
- 外部工具协作：n8n、VS码、光标などとの統合
- 输出文件管理：屏幕快照PDF、Trace保存文件
- 设定可能：通过环境变量进行灵活的设置更改
🛠️ 构成
playwright-replan/
├── Dockerfile # MCPサーバー用コンテナ
├── docker-compose.yml # サービス定義
├── .env # 環境設定
├── scripts/
│ ├── entrypoint.sh # 起動スクリプト
│ └── health-check.sh # ヘルスチェック
├── config/
│ └── mcp-server.json # MCP設定
├── output/ # 出力ファイル
└── docs/
├── SETUP.md # 詳細セットアップ
└── API_USAGE.md # API使用方法
⚙️ 设定
环境变数
｜变量｜默认｜说明｜
|------|-----------|------|
| MCP_HOST_PORT ｜8931｜公共端口｜
| DEBUG ｜-｜启用调试日志｜
| SAVE_TRACE | false | Trace保存 |
| VISION_MODE | false | 屏幕快照模式
启用调试
echo "DEBUG=pw:api" >> .env
docker-compose restart
🔗 外部工具协作
n8n
{
"mcpServers": {
"playwright": {
"url": "http://localhost:8931/sse"
}
}
}
VS代码/光标
{
"mcpServers": {
"playwright": {
"url": "http://localhost:8931/sse"
}
}
}
📊 监视
# ログ確認
docker-compose logs -f
# ヘルスチェック
curl http://localhost:8931/health
# コンテナ状態
docker-compose ps
📚 文档
🔧 故障排除
常见问题
- 端口冲突:
.env单击功能区上MCP_HOST_PORT修改 - 起动失败:
docker-compose logs确认错误 - 无法连接：检查防火墙设置
支持
如果出现问题，请检查：
- 故障排除指南
- 容器日志：
docker-compose logs playwright-mcp - 健康检查：
curl http://localhost:8931/health
📝 许可证
这个项目是实验性的。商务使用时请进行适当的许可证确认。
🤝 貢献
欢迎普尔请求和伊修的报告。
