토스페이먼츠 결제 시스템 연동을 돕는 MCP 서버 구현기

AI 코딩 도구가 토스페이먼츠 연동 코드를 부정확하게 생성하는 문제를 해결하기 위해, 개발자 센터 문서를 제공하는 로컬 MCP 서버를 만들었습니다. 기존에는 사전 정의 키워드로 문서를 찾았지만 긴 문서에서 정보가 누락되고 환각과 반복 호출이 발생해, BM25 검색과 Markdown 헤더 기반 청크 분할을 도입했습니다. 한국어 형태소 분석 라이브러리는 로컬 실행 환경의 의존성을 늘릴 수 있어 제외하고, LLM이 질의를 의미 있는 토큰으로 정리한 뒤 정규식 기반 BM25 점수를 계산하도록 했습니다. 문서 콘텐츠는 기존 CDN의 개발자 센터와 llms.txt를 활용해 최신 상태를 유지하며, 검색 품질과 사용성을 함께 고려해 MCP를 개선해 나가고 있습니다.

• 문서 검색은 사전 키워드 매칭에서 BM25 기반 랭킹으로 발전시킬 수 있습니다.
• 한국어 검색에서는 영어식 정규식 토큰화가 조사와 어미를 제대로 처리하지 못하므로, 질의를 LLM이 의미 있는 토큰으로 정리하도록 활용할 수 있습니다.
• 긴 문서는 Markdown 헤더를 기준으로 나누고, 너무 짧은 청크는 병합해 검색 단위의 맥락을 보존하세요.
• 로컬 MCP는 STDIO와 NPM 배포를 활용하면 별도 서버 운영 비용과 추가 관리 부담을 줄일 수 있습니다.