T-FLEX CAD 17 MCP

공식 T-FLEX-CAD-17-API 지식/API 레이어에 대한 읽기 전용 Model Context Protocol 서버입니다.

배포 경계: 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개 그래프 에지

이 값들은 서버 동작에 포함되지 않고 라이브 스모크 테스트에 의해 동적으로 확인됩니다.