REST API를 명령 한 줄로 AI 도구로, '엠시파이'

기존 REST API를 AI 에이전트가 쓰게 하려면 엔드포인트마다 일일이 래퍼를 손으로 짜야 했다. 엠시파이(Mcpify)는 명령 한 줄로 이 과정을 통째로 없앤다.

무슨 일인가

해커뉴스(Hacker News)에 공개된 오픈소스 도구 엠시파이는 오픈API(OpenAPI) 명세 파일 하나를 가리키면 모든 엔드포인트를 AI 에이전트용 도구로 자동 변환한다. 클로드(Claude)·커서(Cursor)·윈드서프(Windsurf) 같은 에이전트가 곧바로 호출할 수 있는 형태다. 명령은 mcpify https://api.example.com/openapi.json 한 줄이면 되고, 그 순간 명세 속 모든 작업이 살아있는 엠시피(MCP) 도구가 된다.

핵심 짚어보기

배경에는 엠시피(MCP, Model Context Protocol)가 있다. MCP는 AI 에이전트가 실제 외부 도구를 호출하는 표준 통로인데, 기존 API를 여기에 연결하려면 엔드포인트마다 도구 래퍼를 손으로 작성해야 했고 API가 바뀔 때마다 낡아버렸다. 엠시파이는 이미 대부분의 API가 공개하는 오픈API 명세를 읽어 실행 시점에 MCP 서버 전체를 자동 생성한다. 엔드포인트가 N개면 도구도 N개가 코드 없이 만들어지고, 명세를 다시 읽기만 하면 항상 최신 상태로 동기화된다. 인증 키나 토큰도 한 번만 넘기면 모든 호출에 적용된다. 설치는 pipx install mcpify-cli로 끝나며, 오픈API 3.x의 JSON·YAML과 GET·POST·PUT·PATCH·DELETE, 경로·쿼리·헤더 파라미터를 지원한다. 라이선스는 MIT다.

1인기업 실전 적용 포인트

• 이미 쓰는 SaaS(결제·CRM·뉴스레터 등)가 오픈API 명세를 제공한다면, 엠시파이로 즉시 클로드에 물려 '이번 달 미수금 목록 뽑아줘' 같은 자연어 명령으로 조작할 수 있다.
• 사내용 자체 API에도 그대로 통한다. 명세만 있으면 별도 통합 코드 없이 에이전트 자동화 파이프라인에 끼워 넣을 수 있어, 1인 개발자의 시간을 크게 아낀다.
• 인증은 --auth "Authorization: Bearer $TOKEN"처럼 한 번만 설정하면 되니 키 관리가 단순해진다. 단, 토큰은 환경변수로 다루고 코드에 박지 마라.
• API 변경이 잦은 환경이라면 래퍼를 유지보수하는 대신 명세만 갱신해 재생성하라. 유지보수 부담이 사실상 0에 수렴한다.

전망 / 주의점

아직 초기 단계라 한계도 있다. 현재는 단일 전역 인증 헤더만 지원하고, 스웨거(Swagger) 2.0이나 복잡한 스키마 참조($ref) 완전 해석, SSE·HTTP 전송은 로드맵 단계다. 또 명세에 있는 모든 엔드포인트가 도구로 열리므로 권한이 과하게 노출될 위험이 있어, 향후 추가될 작업별 필터링 기능과 함께 신중히 적용해야 한다. 그럼에도 'API를 코드 없이 에이전트에 연결한다'는 방향은 1인기업 자동화의 진입 장벽을 확 낮춘다.

출처: Mcpify (GitHub) (https://github.com/Amanbig/mcpify)