@mcfso/mcp-admin

配置

mcp.json（面板管理，推荐）

{
  "mcpServers": {
    "echo": { "command": "node", "args": ["demo/mcp-echo-server.mjs"] },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    },
    "web": {
      "transport": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "headers": { "Authorization": "Bearer ${MCP_TOKEN}" },
      "disabled": true
    }
  }
}

条目规则：

• 工具名前缀（serverName）取条目 serverName 字段，缺省用 JSON 键名； 必须是 [A-Za-z0-9_-]{1,32}；
• transport 缺省按「有 url 即 streamable-http，否则 stdio」推断， 也接受生态常见的 http/sse 别名；stdio 需要 command，可选 args / env / cwd；
• env / headers 的值做 ${VAR} 展开（官方桥接会清洗父进程环境， 凭据必须这样显式传入）；
• cwd 缺省或为相对路径时相对 mcp.json 所在目录解析；
• disabled: true 停用该服务器；
• 透传 toolCallTimeoutMs、failOnStartupError、reconnect （enabled / initialDelayMs / maxDelayMs / maxAttempts）。

cordis.yml 内联 servers

与官方 @deepseek-ai/dsh-mcp-client 配置一致；内联条目不做 ${VAR} 展开， 取环境变量用 !!js process.env.XXX。

面板使用

• 添加：名称（serverName）、传输方式（stdio / Streamable HTTP）、command、 args（每行一个）、cwd、env（每行 NAME=value）、url、headers（每行 Name: value）、 单次调用超时；
• 状态灯：绿 = 已连接（N 个工具）；黄闪 = 连接中 / 已连接无工具； 红 = 启动失败（卡片显示错误信息）；灰 = 已停用；
• 编辑 / 停用 / 删除：仅 mcp.json 里的服务器；cordis.yml 内联服务器带标签显示、只读；
• 所有改动写入 mcp.json 并即时生效（断开的服务器按官方桥接的重连策略自动恢复）。