Skip to content
Arthur-VOPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BP MVP — MCP Security Scanner

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.

Doel van dit project

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.

Repositorystructuur

bp-mvp/
├── docker-compose.yml
├── roadmap.md
├── goat/
│   └── Dockerfile
└── scanner/
    ├── adapters/
    ├── configs/
    ├── Dockerfile
    ├── config.py
    ├── rulesets/
    └── reports/

Vereisten

  • Docker Engine
  • Docker Compose (v2)

Controle:

docker --version
docker compose version

Snel starten

  1. Clone/open de repository.

  2. Bouw de containers:

docker compose build
  1. Start de stack:
docker compose up
  1. Stoppen:
docker compose down

Huidige status (MVP in opbouw)

  • README.md en roadmap.md zijn aanwezig.
  • Werkende Goat-server in goat/server.py met endpoints /health, /sse en /rpc.
  • Werkende scanner in scanner/client.py met een adapter-laag voor target-agnostische scanning.
  • Config-gedreven targetselectie via YAML/JSON (SCANNER_CONFIG_PATH) met legacy fallback naar TARGET_MCP_URL.
  • Ruleset-profielen (generic, fintech, zowe) voor SAST/fuzzing zonder codewijziging per target.
  • Dependencies en entrypoints zijn geconfigureerd via de Dockerfiles en requirements.txt bestanden.
  • Scanresultaten worden geschreven naar scanner/reports/report.json en scanner/reports/report.md.

Configuratie van targets

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: fintech

Voorbeeld (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: zowe

Voor 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: arguments

Voorbeelden staan ook in:

  • scanner/configs/goat.yaml
  • scanner/configs/zowe.example.yaml

Je kunt nog steeds zonder config-file draaien via TARGET_MCP_URL (legacy pad).

Voorbeeldrun

docker compose up --build --abort-on-container-exit --exit-code-from scanner

Om 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 scanner

PowerShell alternatief (Windows):

$env:SCANNER_CONFIG_PATH = "/app/scanner/configs/zowe.example.yaml"
docker compose up --build --abort-on-container-exit --exit-code-from scanner

Lokaal vanaf de repository-root kun je de scanner ook direct als module draaien:

python -m scanner.client

Na een succesvolle run bevat de scanner-output regels zoals:

  • [scanner] Discovery done. tools=... prompts=... resources=...
  • [scanner] Reports written to /app/reports

Troubleshooting (Linux)

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 --build

Roadmap

De volledige planning en checklist staan in roadmap.md.

Veiligheidsdisclaimer

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages