본문으로 건너뛰기

CLI

패키지는 graph-tool-call 명령을 제공합니다. 로컬에서 tool catalog를 시험하거나, adapter가 저장할 collection artifact를 만들거나, readiness check와 MCP server를 실행할 때 사용합니다.

graph-tool-call --version
graph-tool-call --help

Command 개요​

Command용도
searchbuild 없이 OpenAPI source나 graph file에서 one-shot 검색
ingest재사용 가능한 ToolGraph JSON 생성
retrieve이미 build된 graph 검색
inspect-openapideterministic OpenAPI readiness 진단
build-openapi-collection저장 가능한 collection artifact 생성
analyzegraph 구조, duplicate, conflict, orphan 확인
visualizeHTML, GraphML, Cypher export
infonode/edge summary 출력
dashboardlocal interactive dashboard 실행
callOpenAPI tool search 후 built-in HTTP executor로 호출
serveMCP server로 실행
proxy여러 MCP backend를 aggregate/filter

Build 없이 검색​

graph-tool-call search "find pets by status" \
  --source https://petstore3.swagger.io/api/v3/openapi.json \
  --top-k 8 \
  --scores

script나 fixture에서는 JSON output을 사용하세요.

graph-tool-call search "find pets by status" \
  --source ./openapi.json \
  --top-k 8 \
  --scores \
  --json

같은 source를 반복 검색할 때는 --cache graph.json을 사용합니다.

Build 후 retrieve​

graph-tool-call ingest ./openapi.json -o graph.json
graph-tool-call retrieve "cancel an order" --graph graph.json --top-k 8
graph-tool-call analyze graph.json --duplicates --orphans

주요 ingest flag:

Flag용도
--required-onlyrequired parameter만 유지
--include-deprecateddeprecated operation 포함
--embedding [MODEL]optional embedding index 생성
--organizeautomatic graph organization 실행
--llm PROVIDER/MODELontology enrichment에 LLM 사용
--allow-private-hosts신뢰된 internal URL load 허용
--forcecache가 있어도 rebuild

OpenAPI readiness inspect​

graph-tool-call inspect-openapi ./openapi.json
graph-tool-call inspect-openapi ./openapi.json --json

제품별 field name은 엔진에 하드코딩하지 말고 옵션으로 넘깁니다.

graph-tool-call inspect-openapi ./openapi.json \
  --context-field mallNo,siteNo \
  --paging-field page,size \
  --search-filter-field keyword,searchType

Collection artifact build​

graph-tool-call build-openapi-collection ./openapi.json \
  -o collection.json \
  --context-field mallNo,siteNo \
  --paging-field page,size \
  --auth-field Authorization,X-API-Key

alias 옵션은 alias=canonical 형태입니다.

graph-tool-call build-openapi-collection ./openapi.json \
  --resource-alias goods=product,item=product \
  --action-alias 조회=read,등록=create \
  --module-alias memberMgmt=member

Tool execute smoke​

call은 local smoke test 용도입니다. 운영 adapter는 auth, tenancy, retry, audit, mutation safety를 직접 통제하는 executor를 따로 두는 편이 좋습니다.

graph-tool-call call "find pet by id" \
  --source ./openapi.json \
  --base-url https://petstore3.swagger.io/api/v3 \
  --args '{"petId": 1}' \
  --dry-run

MCP serve/proxy​

graph-tool-call serve --graph graph.json --transport stdio
graph-tool-call proxy --config .mcp.json --top-k 10 --passthrough-threshold 30

관련 문서​