MCP Server With Docker Redis And Timescaledb

🚀 MCP 服務器與 Docker、Redis 和 TimescaleDB

本倉庫藉助 Docker、Redis 和 TimescaleDB 搭建了一個 模型上下文協議 (MCP) 服務器，可實現高效的數據管理。

🚀 快速開始

先決條件

• 已安裝 Docker 和 Docker Compose。
• 安裝版本控制工具 Git。
• 建議安裝 Zsh 和 Oh-My-Zsh（可選，用於增強 shell 體驗）。

設置步驟

1. 克隆倉庫：

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

2. 配置環境變量：

   cp .env.example .env
   

   您可按需修改 .env 文件。
3. 構建並啟動容器：

   docker compose build
   docker compose up -d
   

4. 訪問 MCP 服務器：

   http://localhost:8080
   

重啟後自動恢復

創建 systemd 服務以保持應用程序運行：

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

粘貼以下內容：

[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

啟用服務：

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

✨ 主要特性

• FastAPI：作為 MCP 服務器的網絡框架。
• Redis：提供緩存機制。
• TimescaleDB：基於 PostgreSQL 的時間序列數據庫。
• Docker Compose：調度多容器 Docker 應用程序。
• 環境變量：通過 .env 文件進行配置。
• Systemd 服務：確保服務器在重啟後自動啟動。

📚 詳細文檔

📂 倉庫結構

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

🧪 腳本工具

scripts/ 目錄包含用於自動化基礎設施任務的實用腳本。

🛠️ scripts/full-bootstrap-mcp.sh

💡 適用於新 Ubuntu 虛擬機，用於準備部署 MCP 的完整流程。它會：

• 安裝系統依賴（Docker、Git、Zsh、UFW、Fail2Ban 等）
• 設置 oh-my-zsh 並啟用 jonathan 主題
• 配置遠程桌面環境（XFCE + XRDP）
• 克隆 MCP 倉庫
• 使用 docker compose 構建並啟動應用程序
• 添加 systemd 服務以在重啟後恢復容器

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

📜 scripts/init-repo.sh

用於初始化代碼倉庫：

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

📝 scripts/push-repo.sh

將代碼推送到遠程倉庫：

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

🔧 scripts/setup-mcpserver.sh

配置 MCP 服務器環境：

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

📄 注意事項

⚠️ 重要提示

• 確保所有腳本在運行前都已賦予可執行權限。
• 根據實際需求調整 .env 文件中的配置。
• 使用 docker compose down 關閉容器時，確保不會丟失未保存的數據。

希望這些指南能幫助您順利部署和管理 MCP 服務器！