AI로 REST API 자동화하기, MCP 서버 직접 만든 개발자 이야기

AI로 REST API 자동화하기, MCP 서버 직접 만든 개발자 이야기
Photo by kenny cheng on Unsplash

이 개발자, AI로 REST API 자동화하기를 진짜로 해버렸어.

Claude가 자연어 명령만으로 어떤 REST API든 직접 호출하게 만드는 MCP 서버를 직접 구축하고 오픈소스로 공개한 사람 얘기야.


배경: "API 쓸 때마다 엔드포인트 찾는 게 너무 귀찮았거든"

개발하다 보면 API 문서 열고, 엔드포인트 확인하고, 파라미터 맞춰서 호출하는 반복 작업이 은근히 시간 잡아먹잖아. 이 개발자도 그 지점이 불편했던 거야. 그래서 Claude가 직접 API랑 대화하게 만들면 어떨까 — 거기서 출발한 프로젝트야.


사용한 AI툴과 방법: Claude + MCP 프로토콜 조합

MCP(Model Context Protocol)는 AI 모델이 외부 도구나 서비스랑 연결될 수 있게 해주는 프로토콜이야. 이 개발자는 여기에 REST API 레이어를 붙인 MCP 서버를 만들었어.

사용 방법은 이렇게 돼 있어:

  • Base URL이랑 인증 토큰만 설정하면 준비 끝
  • Cursor나 Claude Desktop에서 자연어로 명령 입력
  • "이번 주에 만들어진 유저 다 보여줘", "이 필드로 새 레코드 만들어줘" 같은 식으로 쓰면 Claude가 알아서 맞는 엔드포인트 찾아서 호출해줘
  • OpenAPI / Swagger 스펙 파일을 로드하면 Claude가 사용 가능한 엔드포인트를 자동으로 전부 인식

코드는 GitHub에 MIT 라이선스로 공개돼 있어 (germanrdev-arg/mcp-rest-api). 가져다 써도 되고 포크해서 수정해도 돼.


AI로 REST API 자동화하기 — 실제 결과

아직 초기 공개 단계라 수익 수치 같은 건 없지만, 반응 자체는 꽤 실용적인 방향으로 흘러가고 있어. 커스텀 통합 작업 문의도 받고 있다고 했거든 — 사내 API나 서드파티 서비스에 이 구조를 붙이고 싶은 팀들한테서. 개발자 혼자 프리랜서 형태로 범위 조율 중인 것 같아.


따라할 수 있는 포인트

  • OpenAPI 스펙이 있는 API라면 바로 적용 가능해. 사내 툴, Notion API, Airtable 같은 데 붙여보면 딱이야
  • Cursor 쓰는 사람이라면 로컬 MCP 서버 연결이 생각보다 진입장벽 낮아
  • "자연어 → API 호출" 흐름 자체를 내부 업무 도구에 접목하면 비개발자 팀원도 데이터 조회·입력 직접 할 수 있게 돼

결국 이 프로젝트의 핵심은 하나야 — AI로 REST API 자동화하기, 문서 안 봐도 Claude가 알아서 엔드포인트 찾아서 쏴주는 구조.

🔗 참고 링크

댓글