🚀 MCP Server with Docker, Redis, and TimescaleDB

🚀 Docker、Redis、TimescaleDB を使用した MCP サーバー

このリポジトリでは、Docker を使用して Model Context Protocol (MCP) サーバーを構築し、効率的なデータ管理のために Redis と TimescaleDB を統合します。

🛠️ 機能

• FastAPI：MCP サーバーの Web フレームワークとして機能します。
• Redis：キャッシュ機能を提供します。
• TimescaleDB：PostgreSQL をベースに構築された時系列データベースです。
• Docker Compose：複数コンテナで構成される Docker アプリケーションを管理します。
• 環境変数：.env ファイルで設定できます。
• Systemd サービス：再起動時にサーバーが自動起動するようにします。

📋 前提条件

• システムに Docker と Docker Compose がインストールされていること。
• バージョン管理用の Git。
• Oh-My-Zsh を使用した Zsh（任意。シェルの操作性を高める場合）。

📂 リポジトリ構成

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

🚀 セットアップ手順

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

---

🧪 スクリプト

scripts/ ディレクトリには、インフラストラクチャのタスクを自動化するユーティリティスクリプトが含まれています。

---

🛠️ scripts/full-bootstrap-mcp.sh

💡 新規の Ubuntu VM ではこのスクリプトを使用して、MCP のデプロイに必要な環境をすべて準備します。以下を実行します。

• システム依存関係（Docker、Git、Zsh、UFW、Fail2Ban など）をインストールします
• jonathan テーマを使用して oh-my-zsh をセットアップします
• XFCE + XRDP でリモートデスクトップを設定します
• MCP リポジトリをクローンします
• docker compose でアプリをビルドして起動します
• 再起動時にコンテナを再起動する systemd サービスを追加します

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

---

📜 scripts/init-repo.sh

新しいローカル Git リポジトリを初期化し、現在のディレクトリをコミットします：

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

---

📤 scripts/push-repo.sh

ローカルリポジトリをリモートにプッシュします（先に URL を更新してください）：

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

---

🧠 scripts/setup-mcpserver.sh

リモート MCP サーバーにアクセスできるよう、ローカルの SSH 環境を設定します。

• 公開鍵をプッシュします
• SSH エイリアスを追加します
• A レコードのサンプルを表示します

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

---

⚠️ 実行前に、プレースホルダーの値（IP アドレス、ユーザー名、リポジトリ URL など）を編集してください。

---

🤝 コントリビューション

このリポジトリは自由にフォークし、イシューを送信したり、プルリクエストを作成したりできます。

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。