knowsuchagency/mcp2cli

해결하는 문제

API를 명령줄 인터페이스(CLI)로 전환하기 위해 맞춤형 코드를 작성하거나 보일러플레이트를 생성할 필요가 없습니다. 특히 AI 에이전트의 '토큰 낭비' 문제를 해결합니다. LLM에 매번 거대한 도구 스키마를 전송하는 대신, 에이전트는 이 CLI를 사용해 도구를 동적으로 탐색하고 호출할 수 있어 토큰 소비를 크게 줄일 수 있습니다.

작동 방식

mcp2cli는 코드 생성 없이 다양한 API 정의를 인스펙션하고 실행 가능한 CLI 명령어로 변환하는 런타임 브리지 역할을 합니다. 다음 네 가지 주요 소스를 지원합니다:

• MCP 서버: HTTP/SSE 또는 stdio 전송 방식으로 연결.
• OpenAPI 사양: JSON 또는 YAML 사양을 사용해 엔드포인트를 명령어로 매핑.
• GraphQL 엔드포인트: 엔드포인트를 인스펙션하여 쿼리 및 변경 작업을 자동 생성.
• Bake 모드: 연결 및 인증 설정을 이름 붙인 구성(예: @petstore)으로 저장해 플래그 반복 입력을 방지.

OAuth(PKCE 및 헤드리스 서버용 수동 콜백 포함)를 내장 지원하고, 환경 변수 또는 파일을 통한 시크릿 관리, 그리고 토큰 효율적인 출력 형식인 TOON을 제공합니다.

대상 사용자

• AI 에이전트 개발자: Claude Code나 Cursor와 같은 에이전트를 사용하며, 프롬프트 컨텍스트를 비대하게 하지 않고도 어떤 API와도 상호작용할 수 있도록 하고 싶은 개발자.
• DevOps/파워 유저: 터미널에서 다양한 API에 빠르고 설정 없이 접근하고 싶은 사용자.

주요 특징

• 코드 생성 없음: 런타임에 API를 CLI로 변환.
• 다중 프로토콜 지원: MCP, OpenAPI, GraphQL 모두 지원.
• 토큰 효율성: 사용 상황에 따라 도구 순위를 정하고, 컴팩트 출력 모드로 LLM 토큰을 절약.
• 포괄적인 인증: 토큰 캐싱 및 갱신을 포함한 내장된 OAuth 흐름 처리.
• 에이전트 통합: 설치 가능한 "스킬"을 제공해 AI 코드 에이전트가 이 도구를 사용하는 방법을 가르칠 수 있습니다.