mcpField
M
MCP Servers

MCP Servers

ローカル
github.com/ajoslin103開発ツール084 週間前に更新
リポジトリ

MCP Servers について

MCP Servers は、Docker Compose で複数の MCP サーバーを構成し、ライフサイクル管理用スクリプトとローカルの MCP Inspector を備えます。Git、ファイルシステム、PostgreSQL、Memory の各サービスをまとめて運用する用途に向いています。

主な機能

  1. 01Docker Compose によるサーバー構成
  2. 02Git リポジトリ操作
  3. 03アクセス制御付きファイルシステム
  4. 04PostgreSQL のスキーマ確認
  5. 05永続的なナレッジグラフメモリ
  6. 06ローカル MCP Inspector

活用シーン

  1. 01複数の MCP サーバーの一括起動
  2. 02PostgreSQL によるデータベーススキーマ確認
  3. 03Inspector でのサーバー管理とデバッグ
  4. 04スクリプトテンプレートによるローカルサーバー追加

MCP 対応

Docker Compose を使って Git、Filesystem、PostgreSQL、Memory の MCP サーバーを実行し、ローカル管理とデバッグ用に MCP Inspector を提供します。スクリプトテンプレートでローカル実行のサーバーを追加できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "servers-ajoslin103": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
起動コマンドdocker run -i --rm compose

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocicompose

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MCP サーバー

このプロジェクトでは、Docker Compose を使用して Model Context Protocol（MCP）サーバーをセットアップします。

含まれるサーバー

  • Git - Git リポジトリの読み取り、検索、操作
  • Filesystem - アクセス制御を設定できる、安全なファイル操作
  • PostgreSQL - スキーマの検査ができるデータベースアクセス
  • Memory - ナレッジグラフベースの永続メモリシステム
  • Inspector - MCP サーバーを管理、デバッグするための GUI ツール（npx を使用してローカルで実行）

セットアップ

  1. リポジトリを初期化します。
./scripts/init-repo.sh

これにより、以下が実行されます。

  • nvm を使用して正しい Node.js バージョンを設定します
  • MCP Inspector をグローバルにインストールします
  1. コンテナ化されたサーバーを起動します。
docker compose up -d
  1. MCP Inspector をローカルで起動します。
./scripts/start-inspector.sh
  1. MCP Inspector を停止します。
./scripts/stop-inspector.sh
  1. コンテナ化されたサーバーを停止します。
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
  1. 両方のスクリプトを編集し、以下を設定します。
  • SERVER_NAME - サーバーの名前
  • NPX_COMMAND - サーバーを実行する NPX コマンド
  • PORT - サーバーが実行されるポート
  1. サーバーパッケージをグローバルにインストールするか、NPX コマンドで指定してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。