MCP Servers

🚀 00_master_mcp コンテナ技術ドキュメント

00_master_mcpコンテナは、マルチエージェントシステムの中央オーケストレーターとして機能し、複数の専用サーバーを調整および管理し、システムリソースとサービスの効率的な呼び出しと統合を実現します。このコンテナは、単一のエントリポイントを介してすべての下流サーバー機能を再利用し、階層化ネームスペース組織ツールを提供します。

🚀 クイックスタート

イメージの構築

docker build -t mcp_master .

コンテナの実行

docker run --network host -d mcp_master

インターフェースのアクセス

http://<ホストマシン>:8000を通じてMCPサービスにアクセスします。

✨ 主な機能

1. 集中制御：FastMCPHostを介して単一のAPIエンドポイントを公開し、複数の専用サーバーを統一的に管理します。
2. ネームスペース分離：階層化ネームスペース（例：os.linux, cloud.azure）を採用してツール名の衝突を回避し、システムの拡張性を向上させます。
3. コンテキスト集約：各専用サーバーの相互作用を調整し、サービス間の機能呼び出しを実現します。
4. セキュリティポリシー：ネームスペースレベルの権限制御により、リソースアクセスのセキュリティを確保します。

📚 ドキュメント

コンテナ構造

• Dockerfile：コンテナ構築のベースイメージ、実行時依存関係のインストール、および起動スクリプトの構成を定義します。
• entrypoint.sh：コンテナ起動時のネットワークインターフェースのバインディングとユーザー権限の制限を構成し、実行の安全性を確保します。
• mcp_host.py：MCPプロトコルの具体的なロジックを実装し、サーバーの登録、リクエストの配信、およびレスポンスの処理を含みます。

ネームスペースポリシー

• トップレベルドメイン：機能カテゴリに基づいて分割されます（例：os, cloud, infra, webなど）。
• サービスの特異性：各トップレベルドメインの下でサブネームスペースを使用して具体的な技術を指定します（例：os.linux, cloud.azure）。
• サブシステムの粒度：さらなるサブネームスペースを通じて特定の機能を組織し、過度のコンテナ化ツールを回避します。

階層化MCPの例

master (:8000)
 ├─ os
 │  ├─ linux           (01_linux_cli_mcp:8001)
 │  │  ├─ cli.*        # 基本コマンドとファイル操作
 │  │  ├─ ceph.*       # Cephクラスタ管理
 │  │  ├─ nginx.*      # Nginxサービス構成
 │  │  ├─ mta.*        # メール転送エージェント操作
 │  │  └─ sftp.*       # SFTPサーバー管理
 │  ├─ windows.*     (02_windows_mcp:8002)
 │  └─ macos.*       (10_macos_mcp:8010)
 ├─ cloud
 │  ├─ azure.*       (03_azure_mcp:8003)
 │  └─ gcloud.*      (04_google_cloud_mcp:8004)
 ├─ infra
 │  ├─ vmware.*      (05_vmware_mcp:8005)
 │  └─ k8s.*         (08_k8s_mcp:8008)
 ├─ web
 │  ├─ search.*      (06_web_search_mcp:8006)
 │  └─ browse.*      (07_web_browsing_mcp:8007)
 ├─ workflows
 │  └─ n8n.*         (09_n8n_mcp:8009)
 ├─ trading
 │  └─ freq.*        (11_freqtrade_mcp:8011)
 ├─ cmdb              (12_cmdb_mcp:8012)
 │  ├─ local.*       # ローカルCSV/SQLiteデータベースツール
 │  └─ servicenow.*  # ServiceNow統合ツール
 └─ secrets           (13_secrets_mcp:8013)
    ├─ keepass.*     # KeePassバックエンドツール
    ├─ azurekv.*     # Azure Key Vaultバックエンドツール
    └─ gcloudsa.*    # Google Cloud Secret Managerバックエンドツール

💻 使用例

基本的な使用法

Dockerfile

# 基礎イメージ
FROM python:3.9-slim

# 実行時依存関係のインストール
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
 && rm -rf /var/lib/apt/lists/*

# 作業ディレクトリの設定
WORKDIR /app

# ファイルのコピー
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

# 起動スクリプトの設定
ENTRYPOINT ["./entrypoint.sh"]

entrypoint.sh

#!/bin/sh
set -e

# 8000ポートをホストマシンにバインド
sed -i "s/127.0.0.1/0.0.0.0/g" /app/mcp_host.py

# 非rootユーザーで実行
useradd -m mcp_user
chown -R mcp_user /app
su -c "python3 /app/mcp_host.py" mcp_user

mcp_host.py

import sys
from fast_mcp import FastMCPHost

def main():
    host = FastMCPHost()
    try:
        host.start("0.0.0.0", 8000)
    except KeyboardInterrupt:
        print("\nStopping MCP Host...")
    except Exception as e:
        print(f"Error: {e}")
        sys.exit(1)

if __name__ == "__main__":
    main()