MCP与A2A工业自动化工作坊

# Clone the repository
git clone https://github.com/iiot-university/MCP_A2A_Workshop.git
cd MCP_A2A_Workshop

# Copy environment template
cp .env.example .env

# Edit .env with your Virtual Factory credentials
# Required variables:
#   MQTT_BROKER, MQTT_PORT, MQTT_USERNAME, MQTT_PASSWORD
#   MYSQL_HOST, MYSQL_PORT, MYSQL_USERNAME, MYSQL_PASSWORD

# Setup each MCP server (creates venv, installs dependencies)
cd day1/mqtt_server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && deactivate && cd ../..
cd day1/mysql_server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && deactivate && cd ../..
cd day1/mes_server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && deactivate && cd ../..

# Install Docker and N8N (see day2/setup/README.md for full guide)
docker run -d --name n8n --restart=always -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n

# Make startup scripts executable (one time)
chmod +x start_servers.sh stop_servers.sh

# Start all Day 2 HTTP servers
./start_servers.sh

# Check Day 2 HTTP servers
curl http://localhost:8001/health          # Production Agent
curl http://localhost:8002/health          # MES HTTP Server

# Check N8N
open http://localhost:5678

# Check MCP servers (in Claude Desktop)
# Ask: "What topics are available in the UNS?"
# Ask: "What is the current OEE for Press 103?"

# Stop HTTP servers
./stop_servers.sh

# Stop N8N (optional)
docker stop n8n

MCP_A2A_Workshop/
├── .env                    # Credentials (gitignored)
├── .env.example            # Template for credentials
├── start_servers.sh        # Start all HTTP servers
├── stop_servers.sh         # Stop all servers
├── README.md               # This file
│
├── day1/                   # Day 1: Advanced MCP
│   ├── mqtt_server/        # Session 2: MQTT/UNS access
│   ├── mysql_server/       # Session 3: MySQL access
│   ├── mes_server/         # Session 4: Domain MES server
│   └── use_cases/          # Session 4: Use case documentation
│
├── day2/                   # Day 2: Agent2Agent
│   ├── setup/              # Docker/N8N setup guide
│   ├── production_agent/   # Session 2: A2A Production Agent
│   └── n8n_integration/    # Session 3: N8N workflows
│
└── logs/                   # Server logs (auto-created)

{
  "mcpServers": {
    "mqtt-uns": {
      "command": "/path/to/day1/mqtt_server/venv/bin/python",
      "args": ["/path/to/day1/mqtt_server/src/mqtt_mcp_server.py"]
    },
    "mysql-mes": {
      "command": "/path/to/day1/mysql_server/venv/bin/python",
      "args": ["/path/to/day1/mysql_server/src/mysql_mcp_server.py"]
    },
    "mes-press103": {
      "command": "/path/to/day1/mes_server/venv/bin/python",
      "args": ["/path/to/day1/mes_server/src/mes_mcp_server.py"]
    }
  }
}