/ 디렉터리 / 플레이그라운드 / mcp2cli
● 커뮤니티 knowsuchagency ⚡ 바로 사용

mcp2cli

제작: knowsuchagency · knowsuchagency/mcp2cli

MCP 서버(또는 OpenAPI/GraphQL 엔드포인트)를 지정하면 셸, 스크립트, 다른 에이전트에서 사용 가능한 타입화된 CLI를 얻습니다 — 코드 생성 불필요.

mcp2cli는 대상 서버의 스키마를 검사하고 런타임에 호출을 디스패치합니다. MCP 서버 검증, 스크립팅, 비에이전트 도구에서 동일한 백엔드 재사용에 유용합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp2cli": {
      "command": "uvx",
      "args": [
        "mcp2cli"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp2cli": {
      "command": "uvx",
      "args": [
        "mcp2cli"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp2cli": {
      "command": "uvx",
      "args": [
        "mcp2cli"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp2cli": {
      "command": "uvx",
      "args": [
        "mcp2cli"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp2cli",
      "command": "uvx",
      "args": [
        "mcp2cli"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp2cli": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp2cli"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mcp2cli -- uvx mcp2cli

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: mcp2cli

LLM 없이 MCP 서버 검증

👤 개발자 ⏱ ~15 min intermediate

언제 쓸까: MCP를 빌드/디버깅할 때 도구를 직접 호출하고 싶을 때.

흐름
  1. 연결
    mcp2cli --target stdio:./your-mcp; list✓ 복사됨
    → 도구 목록 표시
  2. 호출
    mcp2cli call your_tool --arg foo=bar✓ 복사됨
    → 결과 출력

결과: 채팅 클라이언트 없이 빠른 개발 루프.

조합

다른 MCP와 조합해 10배 효율

mcp2cli + fastmcp

fastmcp으로 빌드; mcp2cli로 디버그

mcp2cli와 fastmcp 조합: fastmcp으로 빌드하고 mcp2cli로 디버그✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
list / call / describe (문서 참조) CLI 서브커맨드; MCP 도구로 노출되지 않음 호출 1회

비용 및 제한

운영 비용

API 쿼터
해당 없음
호출당 토큰
해당 없음
금액
무료 OSS
call JSON을 jq로 파이프하여 다운스트림 스크립팅에 활용

보안

권한, 시크릿, 파급범위

자격 증명 저장: 대상이 필요로 하는 것에 따름
데이터 외부 송신: 대상이 에그레스하는 곳으로

문제 해결

자주 발생하는 오류와 해결

스키마를 찾을 수 없음

대상이 MCP / OpenAPI / GraphQL 중 하나를 사용하는지 확인

대안

mcp2cli 다른 것과 비교

대안언제 쓰나단점/장점
MCP InspectorUI가 필요할 때파이프 불가

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기