flowchart LR
    subgraph Agents["🤖 智能体客户端（任选其一）"]
        A1["Claude Desktop"]
        A2["TRAE"]
        A3["Cursor / 自定义 Agent"]
    end

    subgraph MAS["MultiAgentSystem · MCP 服务器"]
        direction TB
        T1["🌡️ get_temperature<br/>感知环境"]
        T2["💡 control_light<br/>执行控制"]
    end

    subgraph Home["🏠 智能家居设备层"]
        D1["温度传感器"]
        D2["智能灯"]
    end

    A1 & A2 & A3 <-->|"MCP 协议（stdio）"| MAS
    T1 -->|"读取数据"| D1
    T2 -->|"下发指令"| D2

git clone https://github.com/Ada-Junk/MultiAgentSystem.git
cd MultiAgentSystem

# 创建虚拟环境并安装依赖（二选一）
uv venv && uv pip install -r requirements.txt        # 方式一：uv
python -m venv .venv                                  # 方式二：pip
pip install -r requirements.txt                       #   （Windows 先执行 .venv\Scripts\activate）

python smarthome_mcp.py        # stdio 传输
# 或使用官方 CLI
mcp run smarthome_mcp.py

{
  "mcpServers": {
    "smarthome-mcp": {
      "command": "python",
      "args": ["D:/path/to/MultiAgentSystem/smarthome_mcp.py"]
    }
  }
}

mcp = MCPServer("smarthome-mcp")

@mcp.tool()
def control_light(room: str, state: str) -> str:
    """打开或关闭指定房间的灯"""
    ...

@mcp.tool()
def control_curtain(room: str, position: int) -> str:
    """设置指定房间窗帘的开合程度

    Args:
        room: 房间名，例如 'living_room'
        position: 开合百分比，0（全关）到 100（全开）
    """
    return f"操作成功: {room} 的窗帘已调整到 {position}%。"

MultiAgentSystem/
├── smarthome_mcp.py    # MCP 服务器：工具定义与注册
├── requirements.txt    # Python 依赖
├── .gitignore          # 忽略虚拟环境、缓存等运行产物
├── LICENSE             # MIT 协议
└── README.md