MCP Servers

00_master_mcp是MCP多智能體系統的核心協調器，負責管理所有下游服務容器的連接、上下文路由、安全策略執行和複雜工作流編排，並提供統一的SSE端點供外部工具訪問。

開發者工具雲平臺 #核心協調器 #多智能體 #工作流 #安全路由 .Python

評分 : 2分

下載量 : 7.4K

更新時間 : 2025-04-29

打開站點

什麼是Master MCP Orchestrator?

Master MCP Orchestrator是整個多代理系統的核心協調器，它作為MCP主機運行，負責管理所有下游MCP服務容器。它提供了一個統一的訪問點，讓外部工具可以通過單一連接間接訪問所有內部服務器。

如何使用Master MCP Orchestrator?

用戶可以通過SSE(服務器發送事件)端點(:8000)連接到Master MCP Orchestrator，然後通過它訪問所有已註冊的服務。Master MCP會負責路由請求到正確的服務並返回結果。

適用場景

適用於需要協調多個專業服務的複雜工作流場景，如跨雲平臺操作、基礎設施管理等。

主要功能

服務協調

維護與所有專業MCP服務的安全1對1連接

上下文管理

聚合、清理和路由LLM與各服務之間的上下文

安全策略

強制執行安全和同意策略

工作流編排

協調跨多個服務的複雜工作流

統一訪問點

提供單一SSE端點(:8000)供外部工具連接

優勢

簡化了多服務系統的訪問和管理

提供統一的安全策略執行點

支持複雜跨服務工作流的編排

通過命名空間組織大量工具，避免命名衝突

侷限性

單點故障風險(可通過高可用部署緩解)

性能瓶頸可能(需要適當擴展)

增加了系統複雜性

如何使用

啟動Master MCP服務

確保Master MCP容器已啟動並運行在端口8000

連接外部工具

配置您的工具(如Cursor、Claude Desktop)連接到Master MCP的SSE端點

訪問服務

通過命名空間路徑訪問特定服務，如'os.linux'或'cloud.azure'

使用案例

跨雲平臺資源查詢

查詢Azure和Google Cloud上的資源並進行比較

基礎設施更新工作流

執行完整的k8s集群更新工作流

常見問題

Master MCP與其他MCP服務的關係是什麼?

如何添加新的MCP服務?

Master MCP支持多少併發連接?

🚀 00_master_mcp 容器技術文檔

00_master_mcp 容器作為多代理系統的中央編排器，能夠協調並管理多個專業化服務器，達成系統資源與服務的高效調用和整合。該容器藉助單一入口點複用所有下游服務器功能，還提供了層次化命名空間組織工具。

🚀 快速開始

構建鏡像

docker build -t mcp_master .

運行容器

docker run --network host -d mcp_master

訪問接口

通過http://<宿主機>:8000訪問MCP服務。

✨ 主要特性

集中控制：通過FastMCPHost暴露單個API端點，統一管理多個專業化服務器。
命名空間隔離：採用層次化命名空間（如os.linux, cloud.azure）避免工具名稱衝突，提升系統擴展性。
上下文聚合：協調各個專業化服務器的交互，實現跨服務功能調用。
安全策略：通過命名空間層級權限控制，確保資源訪問安全性。

📚 詳細文檔

容器結構

Dockerfile：定義了容器構建基礎鏡像、安裝運行時依賴及啟動腳本配置。
entrypoint.sh：配置了容器啟動時的網絡接口綁定和用戶權限限制，保障運行安全。
mcp_host.py：實現了MCP協議的具體邏輯，包括服務器註冊、請求分發和響應處理。

命名空間策略

頂級域名：按功能類別劃分（如os, cloud, infra, web等）。
服務 specificity：在每個頂級域名下使用子命名空間指定具體技術（如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()