knowsuchagency/mcp2cli

해결하는 문제

mcp2cli는 명령줄 인터페이스를 통해 API와 상호 작용하려 할 때 수동 코드 생성이나 사용자 정의 래퍼 작성의 필요성을 제거합니다. 특히 AI 에이전트의 "토큰 낭비" 문제를 해결합니다. 에이전트는 매 턴마다 방대한 도구 스키마를 LLM에 전달하는 대신, 이 CLI를 사용하여 도구를 동적으로 발견하고 호출할 수 있어 토큰 소비를 크게 줄일 수 있습니다.

작동 방식

이 도구는 런타임 브리지 역할을 하여 다양한 API 정의를 검사하고 빌드 단계 없이 실행 가능한 CLI 명령으로 변환합니다. 네 가지 주요 소스를 지원합니다:

• MCP 서버: HTTP/SSE 또는 stdio 전송으로 연결.
• OpenAPI 사양: JSON 또는 YAML 사양을 파싱하여 명령 생성.
• GraphQL 엔드포인트: 엔드포인트를 검사하여 쿼리와 뮤테이션을 자동 생성.
• 로컬/원격 파일: URL 또는 로컬 경로에서 사양을 읽을 수 있습니다.

복잡한 연결 및 인증 설정을 명명된 구성으로 저장하는 "Bake" 모드가 포함되어 있어 사용자는 간단한 @name 접두사로 호출할 수 있습니다. 또한 도구 사용을 로컬에서 추적하여 가장 빈번한 도구를 순위화하여 LLM이 더 적은 토큰으로 올바른 도구를 더 빨리 찾도록 돕습니다.

대상 사용자

• AI 에이전트 개발자: 에이전트(예: Claude Code 또는 Cursor)를 사용하면서 컨텍스트 창을 비대하게 만들지 않고 에이전트가 모든 API와 상호 작용할 수 있게 하려는 사람.
• 고급 사용자/DevOps: 터미널에서 여러 다른 API 표준(MCP, OpenAPI, GraphQL)과 빠르고 통합된 방식으로 상호 작용해야 하는 사람.

주요 기능

• 제로 코드 생성: 런타임에서 API를 CLI로 변환.
• 광범위한 호환성: MCP(HTTP/SSE/stdio), OpenAPI, GraphQL 지원.
• 토큰 효율성: 사용 인식 도구 순위 및 "TOON" 인코딩을 통해 LLM 토큰 비용 최소화.
• 강력한 인증: OAuth(PKCE 및 헤드리스 호스트용 수동 콜백 포함) 및 환경 변수 또는 파일을 통한 비밀 관리 내장.
• Bake 모드: 연결 설정을 저장하여 영구적이고 명명된 CLI 래퍼 생성.