apify/mcpc
The most compatible MCP CLI client. Supports: tools, resources, prompts, completions, async tasks, skills, stdio and streamable HTTP (MCP 2026-07-28 and 2025-11-25), persistent sessions, OAuth 2.1 with DCR, CIMD, client credentials, and ID-JAG, OS keychain, --json for code mode, grep for tool discovery, proxy for AI sandboxes, x402, and more.
mcpc란?
mcpc는 Model Context Protocol (MCP) – AI 에이전트가 도구 호출, 리소스 가져오기, 작업 실행 등을 수행하는 데 사용하는 표준 API – 를 구현하는 모든 서버와 대화할 수 있는 명령줄 클라이언트입니다. 모든 MCP 작업을 간단한 셸 명령으로 변환하므로 다음을 수행할 수 있습니다:
- MCP 서버를 수동으로 검사하고 디버깅할 수 있습니다.
- 일반 Bash 파이프라인과
jq같은 도구로 복잡한 MCP 워크플로우를 스크립팅할 수 있습니다. - AI 에이전트에게 단일
Bash()도구를 제공하여 모든 MCP 서버에 도달하고, 인증, 세션, 결제를 에이전트 대신 처리할 수 있습니다.
요컨대, 이것은 범용 “MCP-to-shell” 브리지입니다.
주요 기능 (README에 설명된 대로)
| 기능 | 의미 |
|---|---|
| 전체 MCP 지원 | 전체 MCP 사양 구현 – 도구, 프롬프트, 리소스, 비동기 작업, 스킬, 알림, 로깅, 상태 저장 및 무상태 프로토콜 버전. |
| 영구 세션 | 기본 서버가 상태 비저장(stateless)이더라도 여러 명명된 연결을 동시에 유지할 수 있습니다. |
| 점진적 도구 발견 | mcpc grep은 서버의 도구 카탈로그를 즉석에서 검색하여 에이전트가 실제로 필요한 도구만 로드할 수 있게 합니다 (토큰 절약). |
| 코드 모드 / JSON 출력 | --json을 사용하면 모든 명령이 단일 JSON 객체를 출력하므로 jq, xargs 또는 다른 셸 유틸리티로 파이프하기에 완벽합니다. |
| 안전한 OAuth 2.1 | 내장 클라이언트 자격 증명 흐름, OS 키체인(또는 헤드리스 시스템의 보호된 파일)에 자격 증명 저장. |
| AI 샌드박싱 | AI 에이전트가 생성한 코드로부터 저장된 자격 증명을 보호하는 프록시 모드. |
| 경량 | 최소 종속성, macOS, Windows, Linux에서 작동하며 LLM 자체를 포함하지 않습니다. |
| 에이전트 결제 (x402) | x402 결제 프로토콜(Base 플랫폼에서 사용)에 대한 실험적 지원. |
누가 사용할까?
| 사용 사례 | mcpc가 어떻게 도움이 되는가 |
|---|---|
| AI 에이전트 개발자 | 수십 개의 MCP 래퍼를 작성하는 대신 에이전트는 Bash 도구에서 mcpc를 호출하여 전체 MCP 기능(도구 호출, 리소스 읽기, 작업 관리 등)을 얻을 수 있습니다. |
| DevOps / 디버깅 | 서버 기능 검사(mcpc @session tools-list), 도구 호출 테스트, 터미널에서 직접 워크플로우 재생. |
| 자동화 / 스크립팅 | mcpc를 표준 Unix 도구(jq, xargs, awk)와 결합하여 MCP 서버와 상호 작용하는 반복 가능한 파이프라인 구축. |
| 보안 중심 팀 | 자격 증명은 OS 키체인에 저장됩니다. 샌드박스 모드는 AI 생성 코드가 자격 증명을 유출하는 것을 방지합니다. |
| 결제 통합 | 실험적인 x402 명령을 사용하여 필요한 MCP 호출에 결제 지갑을 연결합니다. |
작동 방식 (높은 수준의 흐름)
- 로그인 –
mcpc login <server>는 OAuth 2.1 클라이언트 자격 증명 핸드셰이크를 수행하고 토큰을 안전하게 저장합니다. - 연결 –
mcpc connect <server> @name은 명명된 세션(예:@apify)을 생성합니다. 클라이언트는 MCP 버전을 협상하고 경량 브리지 프로세스를 유지합니다. - 명령 실행 – 세션 이름을 명령 앞에 붙입니다. 예:
mcpc @apify tools-call search-actors query:="web crawler". 인수는key:=value쌍, JSON 블롭 또는 stdin을 통해 전달할 수 있습니다. - 스크립트 / 파이프 –
--json을 추가하여 순수 JSON 출력을 얻은 다음jq또는 다른 셸 유틸리티로 파이프합니다. - 세션 관리 – 세션은 나열(
mcpc), 재시작, 닫기, 정리(mcpc clean)할 수 있습니다. 브리지는 네트워크 문제 시 자동으로 재연결되고 OAuth 토큰을 새로 고칩니다.
설치
- Homebrew (macOS/Linux):
brew install mcpc - npm / Bun:
npm install -g @apify/mcpc또는bun install -g @apify/mcpc - Linux에서는 자격 증명이 데스크톱 시크릿 서비스에 저장됩니다. 헤드리스 CI에서는 0600 모드 파일(
~/.mcpc/credentials.json)로 대체됩니다.
빠른 시작 예시
# 세션/프로필 나열
mcpc
# 원격 MCP 서버에 로그인
mcpc login mcp.apify.com
# @test라는 영구 세션 생성
mcpc connect mcp.apify.com @test
# 서버 기능 표시
mcpc @test
# 사용 가능한 도구 나열
mcpc @test tools-list
# 도구 호출 (스크립팅용 JSON 출력)
mcpc --json @test tools-call search-actors keywords:="website crawler"
문서 및 추가 자료
- 전체 명령 참조:
mcpc --help(또는 생성된REFERENCE.md). - MCP 사양: https://modelcontextprotocol.io/specification/latest
- 보안 노트: README는 구성 파일 자동 검색이 비밀 유출을 어떻게 방지하는지 설명합니다.
- 관련 작업: 저장소의 비교 차트는 mcpc가 다른 MCP CLI 클라이언트와 어떻게 비교되는지 보여줍니다.
결론: 인간 또는 AI 에이전트가 MCP 서버와 상호 작용할 수 있는 신뢰할 수 있고 스크립트 가능한 방법(인증, 세션, 도구 발견, 결제까지 처리)이 필요하다면, mcpc는 무거운 AI 라이브러리를 끌어들이지 않고 모든 것을 수행하는 가볍고 Unix 친화적인 래퍼를 제공합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트