MCP server와 Cursor를 활용한 API Client 코드 생성 자동화 작업(openapi-mcp)

코끼릭·2025년 9월 13일

MCP Swagger cursor ide docker openapi

IT

목록 보기

25/25

MCP Server

AI 모델이 추가적인 Context로 활용할 수 있는 정보를 OpenAI가 만든 표준 프로토콜인 Model Context Protocol 형태로 제공하는 서버를 말한다.

Cursor IDE

Visual Code 프로젝트를 fork하여 개발된 AI 기반의 IDE 프로그램으로
Agent Mode 기능을 활성화하면 사용자가 작성한 프로젝트의 코드를 참고하여 코드를 자동으로 작성해준다. 자연어 기반의 instruction을 작성하면 사용자가 원하는 컨벤션에 맞는 코드 작성을 지원하고 커스텀 MCP 서버 설정을 지원해서 사용자 개발 환경에 추가적인 컨텍스트 정보를 커스텀으로 제공하는 것이 가능하다.

Cursor

openapi-mcp + cursor 연동하기

api 서버를 개발하게 되면 사용하는 swagger는 openapi라고 하는 규격에 맞는 공개 api 사용 명세서를 생성하게 되는데 이 문서를 기반으로 한 mcp 서버 오픈소스들이 있다. 이 mcp 서버 기능을 활용하면 백엔드와 프론트엔드 서버에서 api를 호출하기 위한 client 코드 자동 작성을 ai를 활용해서 작성할 수 있게 있다.

개발 환경

openapi-mcp

예제 실습에 사용할 오픈 소스로 다음 환경에서 빌드해서 실행하면 된다.

Go 1.21+
openapi 3.x 버전의 yaml이나 json 파일

빌드 명령어

# 프로젝트 git clone
git clone https://github.com/jedisct1/openapi-mcp.git
cd openapi-mcp

# Build the binaries
make

빌드 산출물

bin/openapi-mcp (mcp 서버를 실행하는 명령어)
bin/mcp-client (interactive client 버전 명령어)

사용 명령어

# Basic usage (stdio mode)
bin/openapi-mcp examples/fastly-openapi-mcp.yaml

1. openapi-mcp 실행 이미지 빌드

서버에 go를 설치하지 않고 도커 이미지로 실행 이미지를 빌드해서 사용한다.

go 환경에서 openapi-mcp를 실행하는 이미지에 대한 dockerfile 작성
실행 이미지 경량화를 위해 빌드 이미지와 실행 이미지 분리한 멀티 스테이지 이미지로 작성

Dockerfile

# syntax=docker/dockerfile:1.7

########################################
# 빌더 스테이지: Go 1.21+로 바이너리 빌드
########################################
FROM golang:1.22-bookworm AS builder

WORKDIR /app

# 빌드 속도를 위해 Go 모듈 캐시 사용
COPY go.mod go.sum ./
RUN --mount=type=cache,target=/go/pkg/mod \
    go mod download

# 프로젝트 전체 복사 후 make로 빌드
COPY . .

# Go 빌드 출력 캐시도 함께 사용
RUN --mount=type=cache,target=/go/pkg/mod \
    --mount=type=cache,target=/root/.cache/go-build \
    make

########################################
# 런타임 스테이지: 실행에 필요한 최소 산출물만 복사된 실행 이미지
########################################
FROM debian:bookworm-slim AS runtime

RUN apt-get update \
    && apt-get install -y --no-install-recommends ca-certificates \
    && rm -rf /var/lib/apt/lists/*

# 빌드된 바이너리 복사
COPY --from=builder /app/bin/openapi-mcp /usr/local/bin/openapi-mcp
COPY --from=builder /app/bin/mcp-client /usr/local/bin/mcp-client

# 스펙/설정 마운트를 위한 기본 작업 디렉터리
WORKDIR /opt/etc/openapi

# HTTP 포트 노출(--http 사용 시)
EXPOSE 8080

# 기본 엔트리포인트(런타임에 override 가능)
ENTRYPOINT ["/usr/local/bin/openapi-mcp"]
# 인자가 없으면 기본으로 도움말 출력
CMD ["--help"]

실행 이미지 빌드

docker build -t openapi-mcp:latest .

2. cursor mcp 서버 설정 추가

cursor IDE에서 실행 가능한 mcp 서버로 실행하기 위해 ~/.cursor/mcp.json 설정 파일 작성

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "sh",
      "args": [
        "-lc",
        "exec docker run --rm -i -v '${프로젝트 json 파일 위치}:/opt/etc/openapi:ro' openapi-mcp:latest /opt/etc/openapi/fastly-openapi-mcp.json 2>/dev/null"
      ]
    }
  }
}