Challeballes MCP Workshop

Vad är MCP?

Model Context Protocol (MCP) är ett öppet protokoll som möjliggör kommunikation mellan AI-modeller och externa verktyg. Det låter dig bygga kraftfulla integrationer där AI kan interagera med databaser, API:er, säkerhetsverktyg och operativsystem.

Arkitektur: Windows Host + Kali VM

I denna workshop använder vi en hybrid-setup där Claude körs på Windows men exekverar kommandon i en Kali Linux VM:

• Windows (Host): Kör Claude Desktop och MCP-bryggan
• Kali Linux (VM): Kör säkerhetsverktyg och exponerar dem via REST API
• MCP Brygga: Översätter mellan MCP-protokollet och Kali API:et

Huvudkomponenter

Vi kommer använda följande projekt: MCP-Kali-Server.
Man är också välkommen att bygga en egen om man hellre vill det :)

• Kali API Server (kali_server.py): Flask-baserad REST API som exekverar kommandon i Kali
• MCP Server (mcp_server.py): Python-applikation som exponerar Kali-funktioner som MCP-verktyg
• Claude Desktop: AI-klient som använder MCP-verktygen

Översikt: Windows + Kali VM

I denna workshop kör vi Claude Desktop på Windows (host) och Kali Linux i en VM (guest). Arkitekturen ser ut såhär:

Vi använder två komponenter:

• kali_server.py: REST API som exponerar Kali-kommandon (körs i Kali VM)
• mcp_server.py: MCP-brygga som översätter mellan MCP och Kali API (körs på Windows, startas av Claude)

Steg 1: Förutsättningar

• Windows 10/11 med Python 3.10 eller senare
• Kali Linux VM (VMware, VirtualBox, Hyper-V, etc.)
• Nätverksanslutning mellan Windows och Kali VM
• Claude Desktop installerat på Windows

Steg 2: Klona MCP-Kali-Server Repository

Ladda ner projektet från GitHub på din Windows-maskin:

git clone https://github.com/Wh0am123/MCP-Kali-Server.git
cd MCP-Kali-Server

Alternativt, ladda ner komponenterna manuellt.

Steg 3: Installera Python-beroenden (Windows)

Installera nödvändiga paket på Windows-maskinen:

pip install mcp requests

Steg 4: Setup Kali VM

4.1 - Kopiera kali_server.py till Kali

Överför kali_server.py till din Kali VM via SCP, delad mapp eller annan metod.

4.2 - Installera beroenden i Kali

# I Kali VM
sudo apt update
pip3 install Flask --break-system-packages

4.3 - Starta Kali API-servern

# I Kali VM
python3 kali_server.py --ip 0.0.0.0

Servern kommer att lyssna på port 5000. Anteckna Kali VM:s IP-adress (använd ip a för att hitta den).

Steg 5: Konfigurera Claude Desktop (Windows)

Redigera Claude Desktop-konfigurationen, observera att man kan behöva skapa filen om den inte finns:

C:\Users\{username}\AppData\Roaming\Claude\claude_desktop_config.json

Lägg till följande konfiguration (byt ut IP-adressen och sökvägen):

{
    "mcpServers": {
        "kali_mcp": {
            "command": "py",
            "args": [
                "C:\\Users\\Charlie\\mcp_server.py",
                "--server",
                "http://192.168.222.128:5000/"
            ]
        }
    }
}

Steg 6: Verifiera Setup

6.1 - Testa Kali API

Från Windows, testa att Kali API:et svarar:

# PowerShell eller CMD
curl http://192.168.222.128:5000/health

6.2 - Starta om Claude Desktop

Stäng och starta om Claude Desktop för att ladda den nya konfigurationen.

6.3 - Testa MCP-anslutningen

Öppna Claude Desktop och testa med en enkel prompt:

Kan du köra "whoami" i Kali?

Felsökning

Grundläggande Prompt-struktur

För bästa resultat med MCP, strukturera dina prompts tydligt och ge så mycket kontext som möjligt.

Mer kontext = Bättre resultat

Inkludera gärna:

• Flaggformat
• IP / URL / Filsökväg till uppgiften
• CTF kategori
• CTF beskrivning
• Eventuella pointers t.ex om du har listat ut första steget men kört fast

Exempel

Kan du hjälpa mig lösa en CTF utmaning i "Cryptography"-kategorin.
Flaggformat: picoCTF{xxx}
Jag har fått två filer som jag lagt under: /home/kali/Desktop/CTF/
CTF beskrivning: "Can you get sense of this code file and write the function that will decode the given encrypted file content."
Använd kali_mcp

Testa dina färdigheter med dessa CTF-utmaningar! Använd MCP-verktygen för att lösa dem.

(Ja flaggan ligger direkt i JavaScripten, men det är inte poängen här)

Vanliga Problem och Lösningar

Nätverksproblem

• Kontrollera firewall-inställningar om servern inte kan nås
• Verifiera att rätt IP-adress och port används
• Testa med telnet localhost 8000 för att bekräfta anslutning