도구 83개짜리 MCP 서버에서 잘못된 호출을 0.35%로 줄인 네 가지 방법
클로더즈 에디터 · 바이브 코딩 · · 좋아요 0 · 답글 0
MCP 서버는 도구가 25개를 넘으면 많다고들 하지만, 사진 편집기처럼 기능이 수백 개인 경우는 줄이기 어렵죠. 데스크톱 Photoshop용 MCP 서버를 만든 개발자가 도구 수를 줄이는 대신 모델이 실제로 얼마나 틀리게 호출하는지를 재며 고친 과정을 공유했어요.
무엇을 만들었나
Editmamei라는 Photoshop MCP 서버로, 도구가 83개예요. Claude Desktop, Claude Code, Cursor 등에서 쓰여요.
어떻게 했나
- 모델이 구별할 수 있는 도구: 사람이 아니라 모델 입장에서 서로 달라 보이게 하고, 설명에 "언제 쓰는지"와 "대신 어떤 이웃 도구를 써야 하는지"를 적었어요.
- 한 가지 일에 도구 하나: 변형은 파라미터로 받아요. 예를 들어 필터 도구 하나가 18종 필터와 5가지 동작을 맡고, 종류별로 인자를 검사해요.
- 허용값을 알려 주는 오류: 잘못 호출하면 가능한 값을 돌려줘서 다음 시도에 바로 고쳐지게 했어요.
- 지도: 짧은 개요와 16개 그룹으로 묶은 기능 지도를 주어 모델이 고르기 전에 방향을 잡게 했어요.
결과와 한계
- 6월 이후 도구 호출 61,977건 중 98.2%가 오류 없이 실행됐고, 실패율은 8월 3.5%에서 10월 1.7%로 내려갔어요.
- 10월 기준 모델이 잘못 부른 호출(스키마 불일치, 없는 옵션·레이어)은 0.35%, 약 290번에 1번이었어요. 나머지 실패의 80%는 Photoshop 응답 지연, 파일 접근 같은 환경 문제였어요.
- 원작성자는 Cloudflare가 도구 두 개(검색·실행)로 2,500개 넘는 API를 다루는 다른 방식을 내놨다며 비교해 볼 계획이라고 했어요.
클로더즈에서 해 볼 점
- MCP 서버를 만든다면 "도구 개수"보다 "잘못된 호출 비율"을 먼저 재 보세요.
- 오류 메시지에 허용값을 넣는 것만으로도 재시도가 줄어드는지 내 서버에서 확인해 볼 만해요.
따라 해 보셨다면 답글로 후기를 남겨 주세요.
태그: #Photoshop #MCP #도구 설계