🚀 MCP Server with Docker, Redis, and TimescaleDB

by chuckwilliams37

198 downloads

Not rated

GitHub

Cloud Service

About

MCP server with Docker, Redis, and TimescaleDB

Details

Author: chuckwilliams37
Downloads: 198
Categories: Cloud Service

- FastAPI web framework for the MCP server
- Redis for caching mechanisms
- TimescaleDB time-series database
- Docker Compose orchestrates multi-container deployment
- Environment variables configurable via .env
- Systemd service for auto-start on reboot
- Utility scripts for bootstrap, repo init, push, and SSH setup

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name 🚀 MCP Server with Docker, Redis, and TimescaleDB

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

From the repository

Clone the repository, copy .env.example to .env and modify as needed, then run docker compose build followed by docker compose up -d. The server is accessible at http://localhost:8080. A systemd service can be configured for automatic restart on reboot.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "\ud83d\ude80 mcp server with docker, redis, and timescaledb": {
            "mcp-server-docker-chuckwilliams37": {
                "command": "docker",
                "args": [
                    "compose",
                    "build"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-docker-chuckwilliams37": {
        "command": "docker",
        "args": [
            "compose",
            "build"
        ]
    }
}

🚀 MCP Server with Docker, Redis, and TimescaleDB

This repository sets up a Model Context Protocol (MCP) Server using Docker, integrating Redis and TimescaleDB for efficient data management.

🛠️ Features

- FastAPI: Serves as the web framework for the MCP server.
- Redis: Provides caching mechanisms.
- TimescaleDB: A time-series database built on PostgreSQL.
- Docker Compose: Orchestrates multi-container Docker applications.
- Environment Variables: Configurable via .env file.
- Systemd Service: Ensures the server auto-starts on reboot.

📋 Prerequisites

- Docker and Docker Compose installed on your system.
- Git for version control.
- Zsh with Oh-My-Zsh (optional, for enhanced shell experience).

📂 Repository Structure

mcp-server-docker/
├── app/
│   └── app.py
├── .env.example
├── docker-compose.yml
├── Dockerfile
├── requirements.txt
├── scripts/
│   ├── bootstrap-mcp.sh
│   ├── full-bootstrap-mcp.sh
│   ├── init-repo.sh
│   ├── push-repo.sh
│   └── setup-mcpserver.sh
└── README.md

🚀 Setup Instructions

1. Clone the Repository:

   git clone https://github.com/chuckwilliams37/mcp-server-docker.git
   cd mcp-server-docker

2. Configure Environment Variables:

   cp .env.example .env

Modify .env as needed.

3. Build and Start the Containers:

   docker compose build
   docker compose up -d

4. Access the MCP Server:

   http://localhost:8080

🔄 Auto-Restart on Reboot

Create a systemd service to keep your app alive:

sudo nano /etc/systemd/system/mcp-docker.service

Paste:

[Unit]
Description=MCP Docker Compose App
Requires=docker.service
After=docker.service
[Service]

WorkingDirectory=/home/youruser/mcp-server-docker

ExecStart=/usr/bin/docker compose up -d

ExecStop=/usr/bin/docker compose down

Restart=always

TimeoutStartSec=0
[Install]

WantedBy=multi-user.target

Enable it:

sudo systemctl daemon-reload
sudo systemctl enable mcp-docker
sudo systemctl start mcp-docker

---

🧪 Scripts

The scripts/ directory contains utility scripts to automate infrastructure tasks.

---

🛠️ `scripts/full-bootstrap-mcp.sh`

💡 Use this on a fresh Ubuntu VM to fully prepare it for MCP deployment. It:

- Installs system dependencies (Docker, Git, Zsh, UFW, Fail2Ban, etc.)
- Sets up oh-my-zsh with the jonathan theme
- Configures Remote Desktop with XFCE + XRDP
- Clones the MCP repo
- Builds and launches the app with docker compose
- Adds a systemd service to relaunch containers on reboot

chmod +x scripts/full-bootstrap-mcp.sh
./scripts/full-bootstrap-mcp.sh

---

📜 `scripts/init-repo.sh`

Initializes a new local Git repository and commits the current directory:

chmod +x scripts/init-repo.sh
./scripts/init-repo.sh

---

📤 `scripts/push-repo.sh`

Pushes your local repo to a remote (update URL first):

chmod +x scripts/push-repo.sh
./scripts/push-repo.sh

---

🧠 `scripts/setup-mcpserver.sh`

Configures your local SSH environment to access a remote MCP server:

- Pushes your public key
- Adds an SSH alias
- Prints a sample A-record

chmod +x scripts/setup-mcpserver.sh
./scripts/setup-mcpserver.sh

---

> ⚠️ Edit placeholder values (e.g., IPs, usernames, repo URLs) before executing.

---

🤝 Contributions

Feel free to fork this repository, submit issues, or create pull requests.

📄 License

This project is licensed under the MIT License.

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 MCP Server with Docker, Redis, and TimescaleDB

🛠️ Features

📋 Prerequisites

📂 Repository Structure

🚀 Setup Instructions

🔄 Auto-Restart on Reboot

🧪 Scripts

🛠️ scripts/full-bootstrap-mcp.sh

📜 scripts/init-repo.sh

📤 scripts/push-repo.sh

🧠 scripts/setup-mcpserver.sh

🤝 Contributions

📄 License

Install

More like this

Aws Kb Retrieval Server

AWS MCP Servers

container-use

container-use

Cloudflare

MCP Gateway

🛠️ `scripts/full-bootstrap-mcp.sh`

📜 `scripts/init-repo.sh`

📤 `scripts/push-repo.sh`

🧠 `scripts/setup-mcpserver.sh`