Claude Kali MCP Commander

# Claude Kali MCP Integration

A clean, minimal implementation of Kali Linux MCP (Model Context Protocol) integration for Claude Desktop, providing secure access to Kali Linux tools through Claude's interface.

## Features

- 🐳 **Docker-based** - Easy deployment with containerization
- 🔒 **Isolated Environment** - Kali Linux tools in a secure container
- 🔄 **Automatic Health Checks** - Ensures service reliability
- 📡 **MCP Server** - Standard protocol for Claude Desktop integration
- 🚀 **Quick Setup** - Get started with a single command
- 🔧 **Configurable** - Customize ports and settings as needed

## Prerequisites

- [Docker](https://docs.docker.com/get-docker/) (v20.10.0+)
- [Docker Compose](https://docs.docker.com/compose/install/) (v2.0.0+)
- [Git](https://git-scm.com/downloads) (for cloning the repository)

## Quick Start

1. **Clone the repository**:
   ```bash
   git clone https://github.com/house-of-stark/Claude-Kali-MCP-Commander.git
   cd Claude-Kali-MCP-Commander
   ```

2. **Start the services**:
   ```bash
   chmod +x start.sh
   ./start.sh
   ```

3. **Configure Claude Desktop**:
   - Open Claude Desktop settings
   - Set MCP Server URL to: `http://localhost:8081`
   - Restart Claude Desktop

## Project Structure

```
.
├── .gitignore           # Git ignore file
├── CONTRIBUTING.md      # Contribution guidelines
├── Dockerfile           # Kali Linux container setup
├── LICENSE              # MIT License
├── README.md            # This file
├── config/              # Configuration files
│   └── claude_desktop_config.json  # Claude Desktop config
├── docker-compose.yml   # Service definitions
├── health-server.js     # Health check server
├── package.json         # Node.js dependencies
└── start.sh             # Helper script to start services
```

## Troubleshooting

- **Port conflicts**: Modify the ports in `docker-compose.yml`
- **Container logs**: `docker logs kali-mcp-commander`
- **Container health**: `docker ps --filter "name=kali"`
- **Network issues**: Ensure Docker has proper network access

## Contributing

Contributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on how to contribute to this project.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Credits

- Original work by Eduard Ruzga (2024)
- Modified and maintained by Chris Stark (2025)
>>>>>>> f2528943306fb6b4af5304651bec9b6f31738d60