多MCP编排平台

# LLM Provider Selection
LLM_PROVIDER=claude          # choices: gemini, claude, openai
GEMINI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here

# LLM Response Configuration (Optional)
MAX_OUTPUT_TOKENS=8192       # Max tokens for LLM responses (default: 8192)
MAX_HISTORY_TOKENS=30000     # Max tokens in conversation history (default: 30000)

docker compose up --build

# Enter the container
docker exec -it mcp-orchestrator-app-1 sh

# Or run commands directly
docker exec mcp-orchestrator-app-1 npm run llm -- mcp list

llm mcp list              # Show all registered MCPs
llm mcp list --enabled    # Show only enabled MCPs
llm mcp list --format json # Output as JSON

# Interactive mode
llm mcp add

# Non-interactive with flags
llm mcp add filesystem \
  --transport stdio-docker \
  --image mcp-server:latest \
  --description "File system operations"

# HTTP/SSE transport
llm mcp add api-server \
  --transport http \
  --url http://mcp-api:8080 \
  --description "External API MCP"

# Local stdio transport
llm mcp add local-mcp \
  --transport stdio \
  --command node \
  --args "dist/mcp-server.js" \
  --description "Local Node.js MCP"

llm mcp enable <name>     # Enable an MCP
llm mcp disable <name>    # Disable without removing
llm mcp remove <name>     # Remove MCP (with confirmation)
llm mcp remove <name> -y  # Skip confirmation

llm mcp health            # Check health of all MCPs
llm mcp test <name>       # Test connection to specific MCP
llm mcp info <name>       # Show detailed MCP information

GET /api/mcp/health

{
  "summary": {
    "total": 1,
    "healthy": 1,
    "unhealthy": 0,
    "reconnecting": 0,
    "disconnected": 0
  },
  "mcps": [
    {
      "name": "filesystem",
      "status": "healthy",
      "lastCheck": 1770827144464,
      "lastSuccess": 1770827144464,
      "consecutiveFailures": 0
    }
  ]
}

POST /api/mcp/add
Content-Type: application/json

{
  "name": "my-mcp",
  "config": {
    "transport": "http",
    "url": "https://example.com/mcp",
    "enabled": true,
    "description": "My MCP server"
  }
}

GET /api/models/available    # Get accessible models
GET /api/models/check         # Diagnostic model testing

MAX_OUTPUT_TOKENS=4096

MAX_HISTORY_TOKENS=50000

User: "Read package.json, README.md, and check the git status"

Orchestrator:
├─ Approval Request (1 of 3): read_file(package.json) → ✓ Approved
├─ Approval Request (2 of 3): read_file(README.md)    → ✓ Approved
├─ Approval Request (3 of 3): execute_command(git status) → ✓ Approved
│
├─ [Parallel Execution]
│  ├─ read_file(package.json) ✓ Complete
│  ├─ read_file(README.md) ✓ Complete
│  └─ execute_command(git status) ✓ Complete
│
└─ Results sent to LLM → LLM analyzes and responds

{
  "mcpServers": {
    "filesystem": {
      "transport": "stdio-docker",
      "containerImage": "mcp-server:latest",
      "enabled": true,
      "description": "Local file system operations",
      "toolPrefix": "fs"
    }
  },
  "settings": {
    "autoConnect": true,
    "healthCheckInterval": 60000,
    "toolNamespacing": "auto"
  }
}

{
  "transport": "stdio-docker",
  "containerImage": "mcp-server:latest",
  "containerEnv": { "VAR": "value" },
  "containerMemory": 512,
  "containerCpu": 0.5
}

{
  "transport": "sse",
  "url": "http://mcp-server:8080/sse",
  "headers": { "Authorization": "Bearer ${API_KEY}" },
  "timeout": 30000
}

{
  "transport": "stdio",
  "command": "node",
  "args": ["dist/server.js"],
  "env": { "NODE_ENV": "production" },
  "cwd": "/app"
}

┌─────────────────────────────────────────────┐
│       Web UI (Vue 3 + TailwindCSS)          │
│  ┌──────────┐  ┌─────────────────────────┐ │
│  │ Chat Tab │  │ MCP Management Dashboard │ │
│  └──────────┘  └─────────────────────────┘ │
└────────────────────┬────────────────────────┘
                     │
┌────────────────────┴────────────────────────┐
│         HTTP API & Socket.IO Server         │
└────────────────────┬────────────────────────┘
                     │
┌────────────────────┴────────────────────────┐
│           MCPHealthMonitor                  │
│  (Periodic checks + Auto-reconnection)      │
└────────────────────┬────────────────────────┘
                     │
┌────────────────────┴────────────────────────┐
│        MCPConnectionManager                 │
│  (Multi-MCP aggregation & routing)          │
└────────────────────┬────────────────────────┘
                     │
      ┌──────────────┼──────────────┐
      │              │              │
  ┌───┴───┐     ┌───┴───┐     ┌───┴───┐
  │ MCP 1 │     │ MCP 2 │     │ MCP 3 │
  │Docker │     │Docker │     │ HTTP  │
  └───────┘     └───────┘     └───────┘

# Install dependencies
npm install

# Build TypeScript
npm run build

# Development mode with watch
npm run dev

npm test

docker build -t mcp-server:latest -f Dockerfile.mcp .

[MCPHealthMonitor] Started with interval 60000ms
[MCPConnectionManager] Connected to MCP: filesystem
[Agent session-xyz] Connected to MCPs: [ 'filesystem', 'api-server' ]
[MCPHealthMonitor] MCP 'filesystem' is now healthy

# Check MCP status
llm mcp health

# Test specific MCP
llm mcp test <name>

# View detailed info
llm mcp info <name>

# Check container logs
docker logs mcp-orchestrator-app-1