T-FLEX CAD 17 MCP

Servidor del Model Context Protocol de solo lectura sobre la capa canónica de conocimiento/API T-FLEX-CAD-17-API.

Límite de despliegue: GitHub Pages es un hosting estático y no puede ejecutar el proceso MCP de Node.js. Por lo tanto, este repositorio despliega un sitio de documentación/diagnóstico de Pages, mientras que el tiempo de ejecución MCP se inicia a través de stdio, HTTP de Node.js o Docker. El conjunto de datos fuente permanece sin cambios en T-FLEX-CAD-17-API.

Arquitectura

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

El servidor MCP nunca modifica el repositorio de la API y no acepta URLs upstream arbitrarias. Solo lee la URL base configurada y las rutas de documentación en la lista blanca.

Related MCP server: oarx-docs-mcp

Herramientas MCP

Todas las herramientas se declaran como solo lectura e idempotentes.

Requisitos

• Node.js 20.11 o más reciente; CI usa Node.js 22.

• Acceso de red a la capa de API estática: https://krickmanc.github.io/T-FLEX-CAD-17-API/.

Servidor stdio local

npm install
npm run start:stdio

Ejemplo de configuración de cliente 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/"
      }
    }
  }
}

Servidor HTTP Streamable

npm install
npm start

Puntos finales predeterminados:

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

• Actividad: GET http://localhost:3000/healthz

• Disponibilidad upstream: GET http://localhost:3000/readyz

• Metadatos del servicio: GET http://localhost:3000/

La implementación HTTP mantiene las sesiones MCP en la memoria del proceso. Para escalado horizontal, use sesiones persistentes o una sola réplica a menos que se agregue un almacén de sesiones compartido.

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

Configuración

Verificación

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 realiza las tres comprobaciones y construye la imagen Docker. Las pruebas de protocolo ejecutan tools/list y tools/call sobre ambos transportes estándar contra una API de fixtures determinista.

GitHub Pages

El flujo de trabajo Deploy GitHub Pages publica el directorio site/. La página verifica la API en vivo y los manifiestos del grafo en el navegador y puede sondear /healthz y /readyz en un tiempo de ejecución MCP desplegado por separado.

Conjunto de datos esperado actualmente de la capa de API

El manifiesto canónico generado el 2026-08-17 informa:

• 17 ensamblados

• 2,452 tipos

• 17,929 símbolos

• 19,350 páginas CHM/ayuda

• 21,558 nodos de grafo

• 45,821 aristas de grafo

Estos valores se verifican dinámicamente mediante la prueba de humo en vivo en lugar de estar incrustados en el comportamiento del servidor.