T-FLEX CAD 17 MCP

只读模型上下文协议服务器，基于规范的 T-FLEX-CAD-17-API 知识/API 层构建。

部署边界： GitHub Pages 是静态托管，无法执行 Node.js MCP 进程。因此，此仓库部署了一个 Pages 文档/诊断站点，而 MCP 运行时通过 stdio、Node.js HTTP 或 Docker 启动。源数据集在 T-FLEX-CAD-17-API 中保持不变。

架构

flowchart LR
    C[MCP client / AI agent]
    M[T-FLEX-CAD-17-MCP\nstdio or Streamable HTTP]
    A[T-FLEX-CAD-17-API\nGitHub Pages: JSONL, Markdown, XML]
    P[T-FLEX-CAD-17-MCP Pages\ndocs and diagnostics]

    C -->|MCP tools| M
    M -->|read-only HTTPS| A
    P -->|manifest diagnostics| A
    P -.->|optional health check| M

MCP 服务器从不修改 API 仓库，也不接受任意的上游 URL。它仅读取配置的基准 URL 和允许列表中的文档路径。

Related MCP server: oarx-docs-mcp

MCP 工具

所有工具均声明为只读且幂等。

要求

• Node.js 20.11 或更新版本；CI 使用 Node.js 22。

• 网络访问静态 API 层：https://krickmanc.github.io/T-FLEX-CAD-17-API/。

本地 stdio 服务器

npm install
npm run start:stdio

MCP 客户端配置示例：

{
  "mcpServers": {
    "t-flex-cad-17": {
      "command": "node",
      "args": ["/absolute/path/T-FLEX-CAD-17-MCP/src/stdio.js"],
      "env": {
        "TFLEX_API_BASE_URL": "https://krickmanc.github.io/T-FLEX-CAD-17-API/"
      }
    }
  }
}

可流式 HTTP 服务器

npm install
npm start

默认端点：

• MCP：POST/GET/DELETE http://localhost:3000/mcp

• 存活检查：GET http://localhost:3000/healthz

• 上游就绪检查：GET http://localhost:3000/readyz

• 服务元数据：GET http://localhost:3000/

HTTP 实现将 MCP 会话保存在进程内存中。对于水平扩展，除非添加了共享会话存储，否则应使用粘性会话或单个副本。

Docker

docker build -t t-flex-cad-17-mcp .
docker run --rm -p 3000:3000 \
  -e TFLEX_API_BASE_URL=https://krickmanc.github.io/T-FLEX-CAD-17-API/ \
  t-flex-cad-17-mcp

配置

验证

npm run check       # JavaScript syntax
npm test            # client, stdio MCP and Streamable HTTP MCP tests
npm run smoke:live  # live manifest, graph, capability and symbol index checks

CI 执行所有三项检查并构建 Docker 镜像。协议测试通过两种标准传输方式针对一个确定性固定 API 执行 tools/list 和 tools/call。

GitHub Pages

Deploy GitHub Pages 工作流发布 site/ 目录。该页面在浏览器中检查实时 API 和图关系清单，并且可以探测单独部署的 MCP 运行时的 /healthz 和 /readyz。

当前期望从 API 层获取的数据集

2026-08-17 生成的规范清单报告：

• 17 个装配体

• 2,452 种类型

• 17,929 个符号

• 19,350 个 CHM/帮助页面

• 21,558 个图节点

• 45,821 条图边

这些值由实时代码烟雾测试动态验证，而非嵌入到服务器行为中。