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:

   cd curl-mcp-server
   

2. Build and start the container:

   docker-compose up -d --build
   

3. Check if it's running:

   docker-compose ps
   

Option 2: Using Docker CLI

1. Build the image:

   docker build -t curl-mcp-server .
   

2. Run the container with host networking:

   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

{
  "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

docker-compose logs

Test the container manually

docker exec -it curl-mcp-server curl -k https://192.168.1.1

Rebuild after changes

docker-compose down
docker-compose up -d --build

Check if container has network access

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

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