MCP Server With Docker Redis And Timescaledb

🚀 MCP Server with Docker, Redis, and TimescaleDB

This repository uses Docker, Redis, and TimescaleDB to set up a Model Context Protocol (MCP) server, enabling efficient data management.

✨ Features

• FastAPI: Serves as the web framework for the MCP server.
• Redis: Provides a caching mechanism.
• TimescaleDB: A time-series database based on PostgreSQL.
• Docker Compose: Orchestrates multi-container Docker applications.
• Environment Variables: Configured via the .env file.
• Systemd Service: Ensures the server starts automatically after a reboot.

📋 Prerequisites

• Docker and Docker Compose installed.
• Git, a version control tool.
• It is recommended to install Zsh and Oh-My-Zsh (optional, enhances the 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

🚀 Quick Start

Step 1: Clone the repository

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

Step 2: Configure environment variables

cp .env.example .env

Modify the .env file as needed.

Step 3: Build and start the containers

docker compose build
docker compose up -d

Step 4: Access the MCP server

http://localhost:8080

🔄 Automatic Recovery after Reboot

Create a systemd service to keep the application running:

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

Paste the following content:

[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 the service:

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

💻 Usage Examples

🛠️ scripts/full-bootstrap-mcp.sh

💡 Suitable for new Ubuntu virtual machines, it prepares the entire process for deploying MCP. It:

• Installs system dependencies (Docker, Git, Zsh, UFW, Fail2Ban, etc.).
• Sets up oh-my-zsh and enables the jonathan theme.
• Configures a remote desktop environment (XFCE + XRDP).
• Clones the MCP repository.
• Builds and starts the application using docker compose.
• Adds a systemd service to restore containers after a reboot.

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

📜 scripts/init-repo.sh

Initialize the code repository:

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

📝 scripts/push-repo.sh

Push the code to the remote repository:

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

🔧 scripts/setup-mcpserver.sh

Configure the MCP server environment:

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

⚠️ Important Note

• Ensure that all scripts have executable permissions before running.
• Adjust the configuration in the .env file according to your actual needs.
• When using docker compose down to shut down containers, make sure no unsaved data is lost.

We hope these guides will help you successfully deploy and manage the MCP server!