VA-MCP

这是一个用于在开发阶段的功能单元测试中，检查并防范 OWASP TOP10 相关漏洞的 MCP。该 MCP 将接收并分析 API 信息，并返回分析产出物。

范围 (MVP)

• 运行 MCP stdio 服务器

• 提供基础工具：

  • ping

  • list_supported_checks

• 未来将扩展 OWASP Top 10 场景

Related MCP server: MCP-QA

前置准备 (Prerequisites)

团队成员在开始开发前必须安装以下内容：

• Git

• uv

• (推荐) Python 3.11+

安装确认：

git --version
uv --version
python3 --version

快速开始 (Quick Start)

# 1) 저장소 클론
git clone <repo-url>
cd VA-MCP

# 2) 의존성/가상환경 동기화
uv sync

# 3) 테스트 확인
uv run pytest -q

# 4) MCP 서버 실행
uv run va-mcp

由于 va-mcp 通过 stdio 传输运行，因此需在 MCP 客户端 (IDE/Agent) 中连接服务器使用。

开发规则

团队开发规则（分支策略、测试、PR、提交规范）请参考 dev-guide.md。

测试指南

功能开发后，请按以下顺序进行测试：

# 1) 의존성 동기화
uv sync

# 2) 테스트 실행
uv run pytest -q

• 测试代码编写在根目录的 tests/ 文件夹中。

• 添加新功能时，必须同时添加相应的测试。

• 最低标准：

  • 至少 1 个功能单元测试

  • tests/test_smoke.py 必须持续通过

目录职责

• src/va_mcp/: 应用程序源代码根目录

• src/va_mcp/server.py: MCP 服务器入口点（执行 va-mcp 时启动的文件）

• src/va_mcp/app.py: FastMCP 应用创建与初始化

• src/va_mcp/config.py: 环境变量加载、输出目录设置

• src/va_mcp/registry/: 注册哪些功能 (tool) 和数据 (resource) 将展示给 MCP

• src/va_mcp/tools/: MCP 实际执行的功能函数（例如：ping、执行检查）

• src/va_mcp/resources/: 功能中通用的基准数据集合（例如：支持的检查列表）

• tests/: 测试代码（开发完成后必须执行）

• outputs/: 执行结果产出物存储

注意事项

• 目前设计基于本地集成 (stdio)。

• 未来在 AWS 部署阶段将转换为 HTTP 方式。