使用说明
🚀 MCP 服务器浏览器与数据库 + Docker MCP 网关
完全集成于Docker MCP网关的定制MCP服务器
🎉 新消息 - 2025年10月
- ✅ 与Docker MCP网关的完全集成
- ✅ 脚本
add-server.sh以便轻松添加新服务器 - ✅ 完整的故障排除文档 翻译成中文是:“以目录格式”
- ✅ 支持SSE和流式传输
- ✅ 优化后的日志 (stderr 用于日志,stdout 为纯 JSON)
- ✅ 稳定化的容器 无需重启循环
📦 可用服务器
🌐 MCP 浏览器调试器
19个工具 用于高级前端调试:
- 网页浏览与操作
- 完全提取DOM和特定元素
- 任意执行JavaScript
- 网页或元素的完整截图
- 控制台日志和网络活动
- Cookies 和 localStorage
- 网站自动登录
- 全面支持SPA(React、Vue、Angular)
🗄️ MCP 数据库
2个工具 用于数据库操作:
- PostgreSQL 和 Oracle Database
- 直接查询SQL和通过自然语言查询
- 优化的连接池
- 强大的错误处理
⚡ 快速入门(3分钟)
1️⃣ 克隆并配置
git clone https://github.com/EmmanuelBarbosaMonteiro/mcp-server-browser.git
cd mcp-server-browser
cp .env.example .env
nano .env # Configure suas credenciais PostgreSQL
2️⃣ 构建并启动
docker compose build
3️⃣ 配置MCP客户端
VSCode(Visual Studio Code,简称VSCode) (C:\Users\Emmanuel\AppData\Roaming\Code\User\mcp.json):
{
"servers": {
"database": {
"command": "node",
"args": ["C:\\Users\\Emmanuel\\Desktop\\mcp\\mcp-database\\dist\\index.js"],
"env": {
"DB_TYPE": "postgres",
"POSTGRES_USER": "shopping",
"POSTGRES_PASSWORD": "shopping123",
"POSTGRES_DATABASE": "shopping_cart",
"POSTGRES_HOST": "localhost",
"POSTGRES_PORT": "5432"
}
},
"browser-debugger": {
"command": "node",
"args": ["C:\\Users\\Emmanuel\\Desktop\\mcp\\mcp-browser\\dist\\index.js"]
},
"mcp-database-docker-image": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"--name", "mcp-database-mcp",
"--add-host", "host.docker.internal:host-gateway",
"--env", "DB_TYPE=postgres",
"--env", "POSTGRES_USER=shopping",
"--env", "POSTGRES_PASSWORD=shopping123",
"--env", "POSTGRES_DATABASE=shopping_cart",
"--env", "POSTGRES_HOST=host.docker.internal",
"--env", "POSTGRES_PORT=5432",
"mcp-mcp-database:latest"
],
"transport": "stdio",
"timeout": 120000
},
"mcp-browser-docker-image": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"--name", "mcp-browser-mcp",
"--add-host", "host.docker.internal:host-gateway",
"mcp-mcp-browser:latest"
],
"transport": "stdio",
"timeout": 120000
}
}
}
🎯 使用场景
浏览器调试
✅ Testar fluxos de autenticação
✅ Extrair dados de websites
✅ Fazer scraping inteligente
✅ Debug de SPAs React/Vue
✅ Automatizar testes E2E
✅ Capturar screenshots
✅ Analisar network requests
数据库操作
✅ Executar queries SQL
✅ Explorar schemas
✅ Análise de dados
✅ Geração de relatórios
✅ Migrations e seeds
📋 要求
- Docker 20.10+
- Docker Compose 2.0+
- Docker MCP 网关 (安装)
- PostgreSQL(中文常译为“波斯特格瑞斯数据库”或直接音译为“波斯特greSQL”,但通常直接使用其英文原名) (对于数据库服务器) - 可选
- 4GB内存 推荐的
- Linux、macOS 或 Windows 与 WSL2 一起(或:使用 WSL2)
🔧 有用命令
# Ver status dos containers
docker compose ps
# Ver logs
docker compose logs -f mcp-browser
docker compose logs -f mcp-database
# Restart
docker compose restart
# Rebuild após mudanças
docker compose build
docker compose down
docker compose up -d
