# 安装依赖
npm install

# 构建
npm run build

# 启动（Web 管理界面 + 统一 MCP 中继）
npm start

外部 MCP 客户端 (Claude Desktop / MCP Inspector)
         │
         ▼
  ┌─────────────────┐
  │ Unified MCP     │  ← 统一中继（对外暴露 relay_* 管理工具）
  │ Server :3101    │
  └────────┬────────┘
           │
  ┌────────▼────────┐
  │ MCP Manager     │  ← 工具路由 + 访问控制 + 日志
  │ + Tool Router   │
  └────────┬────────┘
           │
  ┌────────▼────────┐
  │ Protocol        │  ← stdio / SSE / HTTP 适配器
  │ Adapters        │
  └────────┬────────┘
           │
  ┌────────▼────────┐
  │ 下游 MCP        │
  │ Servers         │
  └─────────────────┘

MCPManager/
├── src/
│   ├── index.ts              # 主入口
│   ├── types.ts              # TypeScript 类型定义
│   ├── storage.ts            # JSON 配置持久化
│   ├── relay.ts              # 独立中继入口
│   ├── core/
│   │   ├── manager.ts        # MCP 连接管理器
│   │   ├── tool-router.ts    # 工具路由表
│   │   └── logger.ts         # 调用日志引擎
│   ├── protocols/
│   │   ├── stdio.ts          # Stdio 传输适配器
│   │   ├── sse.ts            # SSE 传输适配器
│   │   └── http.ts           # Streamable HTTP 适配器
│   ├── server/
│   │   └── unified-server.ts # 统一 MCP 中继服务
│   ├── web/
│   │   ├── index.ts          # Express 管理服务
│   │   ├── auth.ts           # JWT 认证
│   │   └── routes.ts         # 管理 API 路由
│   └── cli/
│       └── index.ts          # Commander CLI
├── public/
│   ├── index.html            # Web 前端
│   ├── style.css             # 样式
│   └── app.js                # 前端逻辑
└── data/
    ├── config.json           # 持久化配置
    └── tool-calls.jsonl      # 调用日志

# 添加 MCP 资源
mcpmanager add <name> --protocol stdio --command "node" --args "server.js"
mcpmanager add <name> --protocol http --url "http://host:port/mcp"
mcpmanager add <name> --protocol sse --url "http://host:port/sse"

# 列出所有 MCP
mcpmanager list

# 启用/禁用 MCP
mcpmanager enable <id>
mcpmanager disable <id>

# 删除 MCP
mcpmanager remove <id>

# 查看工具列表
mcpmanager tools [id]

# 屏蔽工具（正则匹配）
mcpmanager block <id> --pattern "debug_.*"

# 移除屏蔽
mcpmanager unblock <id> --pattern "debug_.*"

# 启动服务
mcpmanager start --port 3100 --relay-port 3101