MCP Docker Compose Setup

by guanghuang

532 downloads
Not rated
GitHub

About

Docker Compose setup for multiple MCP servers (Oracle, PostgreSQL, Jira, etc.) with Nginx proxy, enabling AI assistants to access databases and services via SSE interface.

Details

Author
guanghuang
Downloads
532
Categories
Cloud Service

- Runs eight MCP services in Docker containers
- Uses Nginx as a reverse proxy on port 8088
- Supports SSE transport for MCP communication
- Compatible with Cursor, Windsurf, and similar AI editors
- All Docker images available on Docker Hub
- Provides sample configuration files for each service
- Recommends router-level wildcard DNS for simplicity

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Docker Compose Setup
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Which AI assistants are compatible with this setup?

Tools that support the SSE (Server-Sent Events) interface of MCP, such as Cursor and Windsurf. Tools that only support STDIO (e.g., current versions of Claude Desktop) are not compatible.

What are the prerequisites for running this setup?

You need Docker and Docker Compose installed, plus a DNS configuration that resolves all *-mcp.localhost hostnames to 127.0.0.1. Router-level DNS is recommended but host file entries also work.

How do I customize the configuration for each service?

Edit the corresponding .config files in the mcp-configs directory (e.g., postgres.config for PostgreSQL) with your connection credentials and parameters. You can also modify docker-compose.yml to add, remove, or update services.

How do I update the MCP Docker images?

Run docker-compose pull to fetch the latest images, then docker-compose down followed by docker-compose up -d to restart services. For a single service, use docker pull <image> and `docker-compose up -d --no-deps

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp docker compose setup": {
            "mcp-docker-compose": {
                "command": "docker",
                "args": [
                    "pull",
                    "guang1/jdbc-mcp:latest"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-docker-compose": {
        "command": "docker",
        "args": [
            "pull",
            "guang1/jdbc-mcp:latest"
        ]
    }
}

MCP Docker Compose Setup

This repository contains a Docker Compose configuration for running multiple MCP (Multi-Channel Provider) sse services locally.

Getting Started

Follow these steps to set up and run the MCP Docker Compose environment:

1. Clone the Repository

git clone https://github.com/guanghuang/mcp-docker-compose.git
cd mcp-docker-compose

2. Create Configuration Files from Templates

Copy the sample configuration files to create your own local versions:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.