cd springboot-test-mcp
pip install -e .

pip install httpx "mcp[cli]>=1.6.0" oracledb python-dotenv jmespath

TARGET_BASE_URL=http://localhost:8080
ORACLE_HOST=localhost
ORACLE_PORT=1521
ORACLE_SERVICE=ORCL
ORACLE_USER=your_user
ORACLE_PASSWORD=your_password

{
  "mcpServers": {
    "springboot-test": {
      "command": "python",
      "args": ["/absolute/path/to/springboot-test-mcp/main.py"]
    }
  }
}

claude mcp add springboot-test -- python /absolute/path/to/springboot-test-mcp/main.py

# 检查配置
> check_config

# 发现 API
> discover_api_endpoints

# 功能测试
> call_api(method="GET", path="/api/users")
> run_functional_tests(test_cases=[{
    "name": "创建用户",
    "method": "POST",
    "path": "/api/users",
    "body": {"name": "Alice", "email": "alice@test.com"},
    "assertions": [
      {"target": "status_code", "operator": "eq", "expected": 201},
      {"target": "json_path", "json_path": "name", "operator": "eq", "expected": "Alice"}
    ]
  }])

# 性能测试
> run_perf_test(name="用户列表压测", method="GET", path="/api/users",
                concurrency=50, duration_seconds=30)

# 阶梯压测
> run_stress_test(name="用户API压测", method="GET", path="/api/users",
                  max_concurrency=200, step_size=50, step_duration_seconds=30)

# 数据库验证
> query_database(sql="SELECT * FROM users WHERE name='Alice'")

springboot-test-mcp/
├── main.py                  # 入口
├── server.py                # MCP Tool 定义（所有工具）
├── config.py                # 配置管理
├── core/
│   ├── __init__.py          # HTTP 客户端（httpx）
│   ├── assertion_engine.py  # 断言引擎
│   ├── test_runner.py       # 功能测试执行器
│   └── perf_engine.py       # 性能测试引擎（asyncio 并发）
├── db/
│   ├── __init__.py          # Oracle 连接器（oracledb thin mode）
│   └── oracle_connector.py  # 别名
├── discovery/
│   └── __init__.py          # API 发现（Actuator + 源码扫描）
├── models/
│   └── __init__.py          # 数据模型
├── .env.example             # 环境变量模板
└── claude_desktop_config.json  # Claude 配置参考