MCP Server With Docker Redis And Timescaledb

🚀 MCP サーバーと Docker、Redis、TimescaleDB

このリポジトリは、Docker、Redis、TimescaleDB を使用して モデルコンテキストプロトコル (MCP) サーバー を構築し、効率的なデータ管理を実現します。

✨ 主な機能

• FastAPI：MCP サーバーのネットワークフレームワークとして使用されます。
• Redis：キャッシュ機構を提供します。
• TimescaleDB：PostgreSQL ベースの時系列データベースです。
• Docker Compose：複数のコンテナを持つ Docker アプリケーションを調度します。
• 環境変数：.env ファイルを通じて設定されます。
• Systemd サービス：サーバーが再起動後に自動的に起動することを保証します。

📋 前提条件

• Docker と Docker Compose がインストールされていること。
• バージョン管理ツール Git が必要です。
• Zsh と Oh-My-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 仮想マシンに適しています。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

📋 注意事項

⚠️ 重要提示

1. すべてのスクリプトを実行する前に、実行権限を付与してください。
2. .env ファイルの設定を実際のニーズに合わせて調整してください。
3. docker compose down を使用してコンテナを停止する際に、保存されていないデータが失われないようにしてください。

これらのガイドが MCP サーバーのデプロイと管理をスムーズに行うのに役立つことを願っています！