VA-MCP

Dies ist ein MCP zur Überprüfung von Schwachstellen gemäß OWASP TOP 10 während der funktionalen Unit-Tests in der Entwicklungsphase. Dieser MCP empfängt API-Informationen, analysiert sie und gibt die Ergebnisse der Analyse zurück.

Scope (MVP)

• Ausführung des MCP stdio-Servers

• Bereitstellung grundlegender Tools:

  • ping

  • list_supported_checks

• Zukünftige Erweiterung der OWASP Top 10-Szenarien

Related MCP server: MCP-QA

Voraussetzungen (Prerequisites)

Bevor Teammitglieder mit der Entwicklung beginnen, muss Folgendes installiert sein:

• Git

• uv

• (Empfohlen) Python 3.11+

Installationsprüfung:

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

Da va-mcp über den stdio-Transport arbeitet, wird es durch die Verbindung eines MCP-Clients (IDE/Agent) mit dem Server verwendet.

Entwicklungsregeln

Informationen zu den Team-Entwicklungsregeln (Branch-Strategie, Tests, PR, Commit-Regeln) finden Sie in der dev-guide.md.

Testleitfaden

Nach der Funktionsentwicklung führen Sie die Tests in der folgenden Reihenfolge durch:

# 1) 의존성 동기화
uv sync

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

• Testcode wird im Stammverzeichnis tests/ geschrieben.

• Wenn neue Funktionen hinzugefügt werden, müssen die entsprechenden Tests zwingend mit hinzugefügt werden.

• Mindestkriterien:

  • Mindestens ein funktionaler Unit-Test

  • tests/test_smoke.py muss weiterhin erfolgreich durchlaufen

Verzeichnisstruktur

• src/va_mcp/: Stammverzeichnis des Anwendungscodes

• src/va_mcp/server.py: Einstiegspunkt des MCP-Servers (Datei, die beim Start von va-mcp ausgeführt wird)

• src/va_mcp/app.py: Erstellung und Initialisierung der FastMCP-App

• src/va_mcp/config.py: Laden von Umgebungsvariablen, Konfiguration des Ausgabeverzeichnisses

• src/va_mcp/registry/: Ort zur Registrierung der Funktionen (Tools) und Daten (Ressourcen), die dem MCP angezeigt werden sollen

• src/va_mcp/tools/: Funktionsroutinen, die tatsächlich vom MCP ausgeführt werden (z. B. ping, Ausführung der Prüfung)

• src/va_mcp/resources/: Sammlung von Referenzdaten, die von den Funktionen gemeinsam genutzt werden (z. B. Liste der unterstützten Prüfungen)

• tests/: Testcode (muss nach Abschluss der Entwicklung ausgeführt werden)

• outputs/: Speicherung der Ausführungsergebnisse

Hinweise

• Derzeit ist das System für die lokale Integration (stdio) konzipiert.

• In einer späteren Phase der AWS-Bereitstellung ist eine Umstellung auf den HTTP-Modus geplant.