API 연동 자동화를 위한 MCP 서버 개발

이 게시물은 토스에서 API 스펙 공유와 연동 자동화를 위해 사내 MCP 서버를 개발한 경험을 소개합니다.

MCP 개념과 기능

• MCP(Model Context Protocol)는 LLM과 외부 도구를 연결하는 표준 프로토콜입니다.
• Prompts, Resources, Tools 세 가지 빌딩 블록을 통해 LLM에 컨텍스트와 기능을 제공합니다.

Spring-AI와 MCP 서버 구현

• Spring-AI 프로젝트의 spring-ai-starter-mcp-server-webmvc를 활용해 MCP 서버를 개발했습니다.
• Stateless Streamable-HTTP 프로토콜과 ASYNC 실행 모드를 선택하여 MSA 환경에 적합한 서버를 구현했습니다.
• @Tool 애노테이션을 이용해 LLM이 호출할 수 있는 도구를 선언적으로 개발했습니다.

Swagger MCP 서버 상세 동작 및 문제 해결

• SwaggerCenter에서 서비스 목록과 API 스펙을 단계별로 조회하여 LLM에 제공하는 구조입니다.
• SSE 통신 문제를 Streamable HTTP 방식으로 개선하고, 토큰 초과 에러 대응을 위해 프롬프트 추가 및 설정 고도화를 진행했습니다.
• Swagger 문서 자동화와 MCP Inspector 등 도구를 통해 개발 생산성을 높였습니다.