MVP-omgeving voor een bachelorproef rond geautomatiseerde security assessments van Model Context Protocol (MCP)-servers.
Deze repository bevat twee onderdelen:
- een opzettelijk kwetsbare doelserver (Goat),
- een scanner die de MCP-aanvalsoppervlakte ontdekt en test.
Het doel is een reproduceerbaar framework bouwen dat:
- MCP endpoints en tools automatisch ontdekt,
- statische risico-indicatoren detecteert (SAST-regels),
- dynamische probes/fuzzing uitvoert,
- resultaten exporteert naar een gestructureerd rapport.
bp-mvp/
├── docker-compose.yml
├── roadmap.md
├── goat/
│ └── Dockerfile
└── scanner/
├── adapters/
├── configs/
├── Dockerfile
├── config.py
├── rulesets/
└── reports/
- Docker Engine
- Docker Compose (v2)
Controle:
docker --version
docker compose version-
Clone/open de repository.
-
Bouw de containers:
docker compose build- Start de stack:
docker compose up- Stoppen:
docker compose downREADME.mdenroadmap.mdzijn aanwezig.- Werkende Goat-server in
goat/server.pymet endpoints/health,/sseen/rpc. - Werkende scanner in
scanner/client.pymet een adapter-laag voor target-agnostische scanning. - Config-gedreven targetselectie via YAML/JSON (
SCANNER_CONFIG_PATH) met legacy fallback naarTARGET_MCP_URL. - Ruleset-profielen (
generic,fintech,zowe) voor SAST/fuzzing zonder codewijziging per target. - Dependencies en entrypoints zijn geconfigureerd via de Dockerfiles en
requirements.txtbestanden. - Scanresultaten worden geschreven naar
scanner/reports/report.jsonenscanner/reports/report.md.
De scanner leest standaard SCANNER_CONFIG_PATH en verwacht een YAML/JSON bestand.
Je kunt secrets injecteren met placeholders zoals ${ENV_NAAM}.
Voorbeeld (Goat):
target:
adapter_type: http_rpc
transport_type: http_rpc
base_url: http://goat-server:8080
health_endpoint: /health
sse_endpoint: /sse
rpc_endpoint: /rpc
list_tools_method: list_tools
list_prompts_method: list_prompts
list_resources_method: list_resources
call_tool_method: call_tool
report_dir: /app/reports
ruleset_profile: fintechVoorbeeld (Zowe MCP):
target:
adapter_type: zowe_mcp
transport_type: streamable_http
base_url: https://zowe.example.internal
health_endpoint: ""
sse_endpoint: ""
rpc_endpoint: /mcp
list_tools_method: tools/list
list_prompts_method: prompts/list
list_resources_method: resources/list
call_tool_method: tools/call
initialize_method: initialize
initialized_notification_method: notifications/initialized
session_header_name: mcp-session-id
auth:
bearer_token: ${ZOWE_BEARER_TOKEN}
report_dir: /app/reports
ruleset_profile: zoweVoor wrappers met afwijkende response- of call-keys kun je optioneel mappen:
target:
tools_result_key: tools
prompts_result_key: prompts
resources_result_key: resources
call_tool_name_key: name
call_tool_arguments_key: argumentsVoorbeelden staan ook in:
scanner/configs/goat.yamlscanner/configs/zowe.example.yaml
Je kunt nog steeds zonder config-file draaien via TARGET_MCP_URL (legacy pad).
docker compose up --build --abort-on-container-exit --exit-code-from scannerOm een andere target-config te gebruiken:
SCANNER_CONFIG_PATH=/app/scanner/configs/zowe.example.yaml docker compose up --build --abort-on-container-exit --exit-code-from scannerPowerShell alternatief (Windows):
$env:SCANNER_CONFIG_PATH = "/app/scanner/configs/zowe.example.yaml"
docker compose up --build --abort-on-container-exit --exit-code-from scannerLokaal vanaf de repository-root kun je de scanner ook direct als module draaien:
python -m scanner.clientNa een succesvolle run bevat de scanner-output regels zoals:
[scanner] Discovery done. tools=... prompts=... resources=...[scanner] Reports written to /app/reports
Als Docker faalt met docker-credential-desktop (credential helper ontbreekt), gebruik tijdelijk:
mkdir -p .docker-tmp
printf '{}' > .docker-tmp/config.json
DOCKER_CONFIG=$PWD/.docker-tmp docker compose up --buildDe volledige planning en checklist staan in roadmap.md.
De Goat-component bevat (of zal bevatten) opzettelijk kwetsbaar gedrag voor onderzoeksdoeleinden.
- Gebruik deze omgeving uitsluitend lokaal/in een geïsoleerd lab.
- Niet blootstellen aan publieke netwerken of productie-omgevingen.