transparent-openapi-mcp

OpenAPI v3 스펙을 MCP 도구에 1:1로 투명하게 매핑하는 KISS MCP 서버입니다. 로드된 OpenAPI 스펙이 변경되어도 이 서버의 코드를 변경할 필요가 없는 것이 특징입니다.

Claude Code MCP 서버로 사용하기

세 단계입니다: 이미지를 빌드하고, 서버 측 구성을 설정하고, Claude Code에 연결합니다.

1. 빌드

./podman_build.sh

2. 서버 구성

서버에는 서버 전용 설정이 필요합니다. 컨테이너에 마운트되는 로컬 파일이 설정 목록을 가리키고, 그 설정 목록은 다시 여러분의 OpenAPI 스펙과 백엔드를 가리킵니다. 전체 참고 자료 — 각 파일에 무엇이 들어 있는지, <prefix>_<operationId> 도구 이름 지정 규칙, 그리고 엔드투엔드로 동작이 검증된 실행 가능한 예제 세트 — 는 examples/README.md를 참조하세요.

3. Claude Code에 연결

Claude Code는 컨테이너를 stdio 하위 프로세스로 시작하는 방법을 알고 있어야 합니다. 추가해야 할 정확한 MCP 설정 항목과 2단계의 서버 측 설정과의 관계는 examples/claude-code/README.md에서 확인하세요.

추가한 후 Claude Code 세션에서 /mcp를 실행하고 transparent-openapi-mcp에 해당 도구들이 표시되는지 확인하세요.

Related MCP server: ControlAPI-MCP

번들된 예제로 시도해 보기

실제 스펙/백엔드를 연결하기 전에, 번들된 최소 예제를 사용해 전체 체인이 동작하는지 확인할 수 있습니다.

./podman_build.sh

mkdir -p ~/t-o-m-config
cp examples/*.example.json ~/t-o-m-config/
cd ~/t-o-m-config
mv local-config.example.json local-config.json
mv config-list.example.json config-list.json
mv minimal-openapi.example.json minimal-openapi.json

# in another terminal, serve that directory:
cd ~/t-o-m-config && python3 -m http.server 8000

# back in the first terminal:
./podman_run.sh ~/t-o-m-config/local-config.json

실제로 도구를 호출해 결과를 확인하는 방법을 포함한 전체 과정은 examples/README.md를 참조하세요. 이 명령은 서버를 시작하기만 하며, 서버는 stdio에서 조용히 대기합니다. 이것은 올바른 MCP 동작입니다.

설계 문서

전체 요구사항 세트(R-CTRL, R-DEPLOY, R-CFG, R-BOOT, R-TOOLS, R-FWD, R-STACK, R-RELEASE) 및 설계 내용은 docs/core-mcp-server/requirements.md와 docs/core-mcp-server/architecture.md에서 확인할 수 있습니다.