pnpm install
pnpm build

systems:
  - name: my-system
    description: 我的内部系统
    baseUrl: https://app.example.com
    auth:
      type: sso          # sso | jwt | basic | playwright
      sso:
        authorizeUrl: https://sso.example.com/oauth2/authorize
        tokenUrl: https://sso.example.com/oauth2/token
        clientId: your-client-id
        scope: user_id
        callbackPort: 9527
    tools:
      - name: get_data
        method: GET
        path: /api/data
        description: 获取数据

# 无需 systems.yaml，直接启动
node dist/index.js

{
  "mcpServers": {
    "gateway": {
      "command": "node",
      "args": ["/path/to/mcp-gateway/dist/index.js"]
    }
  }
}

pnpm dev

MCP_GATEWAY_CONFIG=/path/to/your/systems.yaml node dist/index.js

auth:
  type: sso
  sso:
    authorizeUrl: https://sso.example.com/oauth2/authorize
    tokenUrl: https://sso.example.com/oauth2/token
    loginPortal: https://sso.example.com/login    # 可选：统一登录门户
    clientId: your-client-id
    scope: user_id
    callbackPort: 9527

auth:
  type: jwt
  jwt:
    loginUrl: https://api.example.com/auth/login
    refreshUrl: https://api.example.com/auth/refresh
    tokenField: access_token
    refreshField: refresh_token
    expiresIn: 3600

auth:
  type: basic
  basic:
    loginUrl: https://erp.example.com/api/login
    cookieName: SESSION_ID

auth:
  type: playwright
  playwright:
    loginUrl: https://sso.example.com/login        # 登录页 URL（必填）
    successUrl: dashboard                           # 登录成功标志（必填）
    probeUrl: https://app.example.com/api/profile  # 会话探测 URL（可选）
    expiresIn: 1800000                             # 会话有效期（默认 30 分钟）
    channel: chrome                                 # 使用系统 Chrome（可选，避免下载 Chromium）
    # script: ./scripts/login.ts                    # 可选：录制脚本自动登录，失败降级交互式

src/
├── index.ts              # MCP Server 入口 + Tool 注册
├── system-manager.ts     # 动态系统注册/注销 + 工具增删管理
├── config/
│   ├── systems.yaml      # 系统配置（可选，无状态模式不需要）
│   ├── types.ts          # 类型定义
│   └── loader.ts         # 配置加载（无配置时返回空列表）
├── auth/
│   ├── types.ts          # AuthProvider 接口
│   ├── sso-provider.ts   # OAuth2 SSO 认证
│   ├── jwt-provider.ts   # JWT 认证 + 自动刷新
│   ├── basic-provider.ts # 用户名密码认证
│   ├── playwright-provider.ts # Playwright 交互式登录
│   └── manager.ts        # 统一认证管理
└── proxy/
    └── requester.ts      # HTTP 请求 + 凭据注入 + 自动重认证