dockerServerMangerGoMCP

Docker Server Manager Go MCP provides a RESTful API to manage Docker environments. It exposes comprehensive capabilities for containers, images, volumes, networks, and Docker Compose deployments, all secured via JWT authentication and RBAC. The API also includes features for command execution inside containers, file transfers, and deployment tracking for Docker Compose projects. Use the included API documentation (under docs/ in the repository) to understand endpoints, request formats, and authentication flows. The server is designed to be run behind a reverse proxy and can be deployed as a Docker container for easy hosting.

To get started, run the server (via Docker in this configuration) and obtain a JWT token through the authentication endpoints. With a valid token, you can create and manage containers, pull or build images, manage volumes and networks, and validate or deploy Docker Compose configurations. The API supports both persistent PostgreSQL or SQLite backends, depending on deployment, and uses a Go-based Gin framework for routing and middleware. Documentation includes an authentication guide, Docker management references, and a Docker Compose section to orchestrate multi-container setups.

Prerequisites:

• Docker and Docker Compose installed on the host
• Internet access to pull the Docker image

Option A: Run with Docker (recommended for this MCP)

1. Ensure Docker is running on your host.
2. Deploy the MCP using Docker: docker-compose up -d
3. The server will start and be accessible at the configured port (default in the compose file).

Option B: Run the Docker image directly (alternative)

1. Pull and run the image: docker run -d --name docker-server-mcp -p 8080:8080 threatflux-dockerservermangergomcp
2. Use the exposed port (default 8080) to access the API and authenticate.

Environment and configuration:

• If you need Postgres for production, configure the database connection strings via environment variables as defined in the docs (e.g., DATABASE_URL).
• JWT_SECRET and other security-related variables should be set according to your environment and security requirements.

Notes and tips:

• Ensure proper network access and firewall rules to allow API access to your Docker host and any external databases.
• For production, prefer PostgreSQL over SQLite and configure schema migrations as described in the docs.
• Enable JWT authentication and RBAC to protect sensitive endpoints.
• If you encounter image pull issues, verify Docker daemon permissions and ensure the host has network access to Docker Hub or your private registry.
• Use the Docker Compose feature to deploy multi-container stacks and manage deployment status via the API.
• Check the docs directory for API reference, authentication guidance, and Docker management details to leverage all available endpoints.