# Curl MCP Server for Docker
This is a Model Context Protocol (MCP) server that provides curl functionality with full network access.
## Features
- Execute curl commands with all options and flags
- Host network mode for accessing local network devices (like your FortiGate at 192.168.1.1)
- Supports HTTPS with self-signed certificates (-k flag)
- Custom headers and authentication
- 5-minute timeout for long-running requests
## Installation
### Option 1: Using Docker Compose (Recommended)
1. Navigate to this directory:
```bash
cd curl-mcp-server
```
2. Build and start the container:
```bash
docker-compose up -d --build
```
3. Check if it's running:
```bash
docker-compose ps
```
### Option 2: Using Docker CLI
1. Build the image:
```bash
docker build -t curl-mcp-server .
```
2. Run the container with host networking:
```bash
docker run -d --name curl-mcp-server --network host curl-mcp-server
```
## Configuration with Claude Desktop
To use this MCP server with Claude Desktop, add the following to your MCP settings configuration file:
**On macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**On Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"curl": {
"command": "docker",
"args": ["exec", "-i", "curl-mcp-server", "python", "/app/server.py"]
}
}
}
```
After adding this configuration:
1. Restart Claude Desktop
2. The curl tool should now be available
## Usage Examples
Once configured, you can use curl commands in Claude:
```
curl -k https://192.168.1.1
```
```
curl -k -H "Authorization: Bearer YOUR_API_KEY" https://192.168.1.1/api/v2/monitor/system/status
```
```
curl -X POST https://api.example.com/endpoint -d '{"key":"value"}'
```
## Network Access
This container uses `network_mode: host` which gives it direct access to:
- Your local network (192.168.x.x addresses)
- The internet
- All network interfaces on your host machine
## Troubleshooting
### Container not starting
```bash
docker-compose logs
```
### Test the container manually
```bash
docker exec -it curl-mcp-server curl -k https://192.168.1.1
```
### Rebuild after changes
```bash
docker-compose down
docker-compose up -d --build
```
### Check if container has network access
```bash
docker exec -it curl-mcp-server curl https://google.com
docker exec -it curl-mcp-server curl -k https://192.168.1.1
```
## Stopping the Server
```bash
docker-compose down
```
## Security Notes
- This server has full network access due to host networking mode
- Be careful with the commands you execute
- The container can access all devices on your local network
- Consider firewall rules if you're concerned about security
