# 克隆项目
git clone 
cd percepta-mcp

# 安装依赖 (推荐使用 uv)
uv venv
uv sync

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，添加您的 API 密钥

# 安装浏览器驱动
uv run playwright install chromium

# 启动服务
uv run python -m src.percepta_mcp.server

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件

# 构建并启动
docker-compose up -d

# 查看状态
docker-compose ps
curl http://localhost:8000/health

{
  "mcpServers": {
    "percepta-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.percepta_mcp.server"],
      "cwd": "/path/to/percepta-mcp"
    }
  }
}

{
  "mcpServers": {
    "percepta-mcp": {
      "command": "docker",
      "args": ["exec", "percepta-mcp", "uv", "run", "python", "-m", "src.percepta_mcp.server"]
    }
  }
}

{
  "mcp.servers": {
    "percepta-mcp": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.percepta_mcp.server"],
      "cwd": "${workspaceFolder}"
    }
  }
}

percepta-mcp/
├── src/percepta_mcp/
│   ├── server.py          # MCP 服务器主入口
│   ├── config.py          # 配置管理
│   ├── ai_router.py       # AI 提供商路由
│   └── tools/             # 工具模块
├── tests/                 # 测试文件
├── .env.example           # 环境变量模板
├── docker-compose.yml     # Docker 部署配置
└── Dockerfile             # Docker 镜像构建

# 运行所有测试
uv run pytest

# 带覆盖率报告
uv run pytest --cov=src --cov-report=html