MCP Servers Vo1

🚀 MCP サーバー設定ガイド

このプロジェクトでは、Docker Compose を使用して Model Context Protocol (MCP) サーバーをデプロイします。

🚀 クイックスタート

このガイドでは、MCP サーバーの設定方法を説明します。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• Git - Git リポジトリの読み取り、検索、操作が可能です。
• ファイルシステム - アクセス制御を設定可能なセキュアなファイル操作ができます。
• PostgreSQL - データベースへのアクセスとスキーマのチェックができます。
• メモリ - 知識グラフに基づく永続的な記憶システムが備わっています。
• Inspector - MCP サーバーを管理およびデバッグするための GUI ツールです（npx を通じてローカルで実行）。

📦 インストール

1. リポジトリの初期化

./scripts/init-repo.sh

このコマンドでは、以下のことが行われます：

• nvm を使用して正しい Node.js バージョンを設定します。
• MCP Inspector をグローバルにインストールします。

2. コンテナ化されたサーバーの起動

docker compose up -d

3. ローカルでの MCP Inspector の起動

./scripts/start-inspector.sh

4. MCP Inspector の停止

./scripts/stop-inspector.sh

5. コンテナ化されたサーバーの停止

docker compose down

📚 ドキュメント

ディレクトリ構造

• docker-data/ - 各 MCP サーバーのデータディレクトリです。
• docker-files/ - Dockerfile のリソースファイルが格納されています。
• scripts/ - サービスを管理するためのユーティリティスクリプトがあります。
  • init-repo.sh - リポジトリを初期化し、Node.js とパッケージを正しく設定します。
  • start-inspector.sh - MCP Inspector をバックグラウンドで起動します。
  • stop-inspector.sh - MCP Inspector を停止します。
  • テンプレートフォルダ：
  • template-start-mcp-server.sh - MCP サーバーの起動スクリプトを作成するためのテンプレートです。
  • template-stop-mcp-server.sh - MCP サーバーの停止スクリプトを作成するためのテンプレートです。

設定

各サーバーは、docker-compose.yml ファイル内の環境変数を通じて設定することができます。

Inspector へのアクセス

MCP Inspector は、起動後に http://localhost:5173 からアクセスできます。

ログ記録

• Inspector のログは ./docker-data/inspector/inspector.log に保存されます。

新しい MCP サーバーの追加

新しいローカル実行（Docker 化されていない）の MCP サーバーを追加するには、以下の手順を実行してください。

1. テンプレートスクリプトのコピー

cp scripts/template-start-mcp-server.sh scripts/start-newserver.sh
cp scripts/template-stop-mcp-server.sh scripts/stop-newserver.sh
chmod +x scripts/start-newserver.sh scripts/stop-newserver.sh

2. スクリプトの編集

2 つのスクリプトを編集して、以下の設定を行ってください：

• SERVER_NAME - サーバー名
• NPX_COMMAND - サーバーを実行するための npx コマンド
• PORT - サーバーが実行されるポート

3. サーバーパッケージの確認

サーバーパッケージがインストールされていることを確認するか、npx コマンド内で指定してください。