MCP Kali Server

After installation, configure your MCP client to connect to the Kali server:

- Setting up.claude/mcp_settings.jsonfor Claude Desktop
- Configuring alternative MCP clients
- Finding your Python path and Kali IP address
- Platform-specific examples (Windows, Linux, macOS)

If you're running Kali Linux in WSL 2, proper network configuration iscriticalfor the MCP server to function. See our comprehensive guide:

- Essential WSL configuration (wsl.conf)
- DNS resolution setup for Kali tools
- Critical: Understanding WSL 2 localhost behavior (Windows → Kali communication)
- Network testing and troubleshooting

⚠️Important: The MCP client on Windowsmustbe able to access the Kali server vialocalhost. Review this guide before running the server.

This project now separates Python dependencies for the two runtime components:

- requirements.kali.txt– Only what the Kali API server Python code needs (Flask, etc.)
- requirements.mcp.txt– Dependencies for the MCP server client interface (requests, FastMCP, test libs)
- requirements.txt– Informational file describing the split; contains no direct packages now.

pip install -r requirements.kali.txt # On Kali host running kali-server/ pip install -r requirements.mcp.txt # On host running mcp-server/

IMPORTANT: Be extremely cautious when running the Kali server withsudoprivileges:

# ⚠️ DANGEROUS - Avoid if possible sudo python kali_server.py

- The entire server runs with root privileges
- All API endpoints and commands execute with full system access
- Any compromise of the server grants complete root access to the system
- No privilege separation or access control

- Run the server as a regular user (many tools work without root)
- Use specific sudo permissions only for commands that require them
- Consider containerization or virtualization for isolation
- Implement privilege escalation only when absolutely necessary

For production environments: Please seeTODO.mdfor planned security enhancements including granular privilege management and access controls.

The project includes comprehensive test suites using Docker containers for isolated testing environments.

cd tests ./run_all.bat # Windows # or chmod +x run_all.sh && ./run_all.sh # Linux

cd tests/docker docker-compose up -d --build python test_config_docker.py

cd tests/kali python -m pytest test_ssh_manager.py -v

Tests use Docker containers for consistent and isolated testing environments. The configuration is automatically set up in:

- tests/kali/test_config.py- Main test configuration (Docker-based)
- tests/docker/test_config_docker.py- Docker-specific test configuration

The MCP server provides the following tools:

# The system automatically verifies file integrity using SHA256 checksums upload_result = { "success": True, "source_checksum": "abc123...", "remote_checksum": "abc123...", "checksum_verified": True, "integrity_check": "PASSED" }

# All downloads include automatic integrity verification download_result = { "success": True, "remote_checksum": "def456...", "local_checksum": "def456...", "checksum_verified": True, "integrity_check": "PASSED" }

- Testing Environment: All tests use isolated Docker containers for security
- Network Security: Ensure proper firewall configuration
- Authentication: Use strong passwords and key-based authentication
- Session Management: Regularly clean up unused sessions
- File Permissions: Set appropriate file permissions on uploaded files
- Logging: Monitor all activities through comprehensive logging

# Check if server is running curl http://localhost:5000/health

# Verify SSH connectivity ssh user@target-host

# Install missing tools sudo apt update && sudo apt install nmap gobuster

If you encounter Docker-related errors when using--testmodeon Kali Linux:

# Install Docker sudo apt update && sudo apt install docker.io # Start Docker service sudo systemctl start docker sudo systemctl enable docker # Add user to docker group (then logout/login) sudo usermod -aG docker $USER # Test Docker access docker --version docker ps

If Docker commands work manually but fail in test mode:

- The issue might be PATH-related in the Python environment
- Try running with sudo:sudo python kali_server.py --test
- Check Docker socket permissions:ls -la /var/run/docker.sock
- Ensure you're running this on Kali Linux, not Windows

# For the server python kali_server.py --test --debug # For Python logging import logging logging.basicConfig(level=logging.DEBUG)

- Fork the repository
- Create a feature branch
- Follow the coding standards (English comments, proper naming)
- Add comprehensive tests
- Update documentation
- Submit a pull request

- All code, variables, and functions must be in English
- All comments and documentation must be in clear English
- Follow standard naming conventions
- Add tests for new features or bug fixes
- Update README and documentation

⚠️ Disclaimer: This tool is designed for authorized penetration testing and security research only. Users are responsible for complying with applicable laws and regulations.

Security testing MCP server with 51 tools for penetration testing, network forensics, memory analysis, and vulnerability assessment.

This tool creates an MCP server to bridge the gap between AI workflows and EMBA security analysis.

A complete Model Context Protocol (MCP) server for Fortinet FortiOS 7.6.6

A Python MCP Server that connects Large Language Models natively to a comprehensive suite of offensive security tools.

A server that allows MCP clients to use Suricata for network traffic analysis.

MCP access to cluster-wide L4 and L7 network traffic, packets, APIs, and complete payloads.

Interact with the Illumio Policy Compute Engine (PCE) to manage workloads, labels, and analyze traffic flows.

MCP server for managing pfSense firewalls through AI assistants — firewall rules, DHCP, DNS, gateways, ARP, and services. 17 tools with two-step confirmation for destructive operations.

Network reconnaissance and security scanning with port scanning, DNS analysis, and vulnerability assessment