后端 OpenAPI → normalized.json → catalog.json + embeddings.json（向量）
                                      ↓
LLM 按「搜索 → 取参数 → 调用」编排，动态使用全部 237+ 接口：
   search_endpoints → get_endpoint_schema → call_endpoint

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt          # 运行时依赖：mcp / httpx / pydantic

python -m tools.mcp_catalog            # 生成目录 + 向量
python -m tools.mcp_catalog --no-embed # 只生成目录，跳过向量编码

MCP_TRANSPORT=http MCP_HOST=0.0.0.0 MCP_PORT=8000 python -m justoneapi.mcp.server

{
  "mcpServers": {
    "justoneapi": {
      "url": "http://<服务器IP或域名>:8000/mcp",
      "headers": {
        "Authorization": "Bearer <你的 justone token>",
        "X-DashScope-Key": "<你的百炼 key>"
      }
    }
  }
}

python -m scripts.sync_mcp            # 拉上游 → 有变更才重建（含接口 diff）
python -m scripts.sync_mcp --dry-run  # 只看差异，不写不重建
python -m scripts.sync_mcp --force    # 即使无变更也重建

just-one/
├── justoneapi/
│   ├── _transport.py          # 稳定调用出口 Transport.get(path, params)
│   ├── _exceptions.py
│   ├── _response.py
│   ├── _version.py
│   ├── log.py
│   ├── mcp/
│   │   ├── server.py          # FastMCP 入口，注册 6 个工具
│   │   ├── search.py          # 语义检索
│   │   ├── executor.py        # 参数校验 + 多租户 token + 调用
│   │   ├── catalog.py         # 内存目录 + mtime 热加载
│   │   ├── embedding.py       # 百炼 text-embedding-v4 封装
│   │   └── config.py          # 环境变量与平台别名
│   └── mcp_data/              # 运行时产物（生成）
│       ├── catalog.json
│       ├── embeddings.json
│       └── embeddings.meta.json
├── openapi/
│   └── public-api.normalized.json   # 接口目录唯一数据来源（由上游同步）
├── scripts/
│   └── sync_mcp.py            # 同步上游 + 重建（无需凭证）
├── tools/
│   └── mcp_catalog.py         # 由 normalized.json 生成 catalog + 向量
├── docs/
│   └── mcp-server-design.md
├── requirements.txt
├── pyproject.toml
└── README.md