# mcporter

MCPorter는 Model Context Protocol(MCP)을 위한 TypeScript 런타임, CLI 및 코드 생성 도구 키트입니다. 제로 설정 발견으로 모든 MCP 서버를 독립 실행형 CLI 또는 타입 지정 API로 발견, 호출 및 변환하세요.

Canonical URL: https://a2a-mcp.org/entry/mcporter-ko

Language: ko

Category: Tools & Extensions

Updated: 2026-04-06

## 개요

**mcporter** (MCPorter 🧳)는 [모델 컨텍스트 프로토콜(MCP)](https://github.com/modelcontextprotocol/specification)을 위한 오픈소스 **TypeScript 런타임, CLI 및 코드 생성 도구 모음**입니다. 개발자와 AI 에이전트가 구성된 MCP 서버를 탐색하고, 도구를 직접 호출하며, TypeScript로 자동화 작업을 구성하고, 모든 MCP 엔드포인트에서 단일 목적 CLI를 생성할 수 있도록 합니다.

Anthropic의 "MCP를 통한 코드 실행" 가이드라인을 지원하도록 구축되어, AI 에이전트가 방대한 JSON 스키마를 로드하는 대신 경량 CLI 바이너리를 통해 도구를 호출할 수 있게 함으로써 상용구 코드와 컨텍스트 윈도우 부풀림 현상을 제거합니다.

최신 버전: **0.8.2** (2026년 3월). MIT 라이선스.

## 기능

- **제로 설정 탐색**: `~/.mcporter/mcporter.json`, 프로젝트 설정 및 Claude, Cursor, Codex, VS Code, Windsurf, OpenCode와의 통합으로부터 MCP 서버를 자동으로 찾습니다.
- **CLI 중심 도구 호출**: 자연스러운 구문(`mcporter call linear.create_comment ...`) 또는 함수 호출 스타일로 도구 실행 — 스키마 지식이 필요 없습니다.
- **한 줄 명령 CLI 생성**: `mcporter generate-cli`는 모든 MCP 서버에서 독립형, 자체 포함 CLI(Bun/Node)를 생성하여 쉬운 공유 및 에이전트 사용을 가능하게 합니다.
- **타입 지정 TypeScript API**: `mcporter emit-ts`는 강력한 타이핑, 기본값 및 유효성 검사와 함께 `.d.ts` 인터페이스 또는 전체 클라이언트 래퍼를 생성합니다.
- **구성 가능 런타임**: 연결 풀링, OAuth 캐싱, 로그 추적 및 HTTP/SSE/stdio 전송 지원과 함께 `createRuntime()` + `createServerProxy()`를 제공합니다.
- **임시 및 데몬 모드**: 모든 MCP 엔드포인트에 즉시 연결; 데몬 명령으로 상태 유지 서버(예: chrome-devtools)를 준비 상태로 유지합니다.
  
- **AI 에이전트 친화적**: 컨텍스트 부풀림 감소 — 에이전트는 전체 MCP 스키마를 임베딩하는 대신 작은 CLI 바이너리를 호출합니다.
- **견고한 도구 기능**: 자동 수정, 풍부한 출력 포맷팅(`text()`, `json()`), 설정 관리 및 디버그 도우미.

## 사용 사례

- **AI 에이전트 도구 통합**: Claude/Cursor가 생성된 CLI를 통해 복잡한 MCP 서버를 호출하도록 하여 컨텍스트 윈도우가 폭발적으로 증가하는 것을 방지합니다.
- **신속한 자동화 스크립팅**: 완전한 타입 안전성과 함께 여러 MCP 도구를 구성하는 TypeScript 워크플로우를 구축합니다.
- **도구 공유**: 팀 또는 공개 사용을 위해 단일 목적 CLI(예: `linear-comment`)를 생성 및 배포합니다.
:
- **개발 및 디버깅**: 프로토타이핑 중에 모든 MCP 서버 스키마를 즉시 검사하거나 도구를 임시로 호출합니다.
= **MCP 부풀림 감소**: 편집기/에이전트에서의 무거운 스키마 로딩을 경량 CLI 호출로 대체합니다.

## 설치 및 빠른 시작

### 즉시 실행 (설치 없음)
```bash
npx mcporter list
npx mcporter list linear --schema
```

### 전역 설치
```bash
npm install -g mcporter
# 또는 Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter
```

### 호출 예제
```bash
# 콜론 구문
mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'

# 함수 호출 구문
mcporter call 'linear.create_comment(issueId: "ENG-123", body: "Looks good!")'
```

# CLI 생성하기
mcporter generate-cli --command https://mcp.context7.com/mcp
```

### TypeScript 사용법
```ts
import { createRuntime } from "mcporter";
const runtime = await createRuntime();
const result = await runtime.callTool("context7", "resolve-library-id", {
  args: { libraryName: "react" }
});
console.log(result.text());
await runtime.close();
```

전체 문서, CLI 참조 및 예제는 [저장소](https://github.com/steipete/mcporter)에서 확인하세요.

## 왜 mcporter인가요?

MCP는 도구를 통해 AI 에이전트에 슈퍼파워를 부여하지만, 스키마와 연결을 관리하는 것은 번거로운 작업입니다. mcporter는 MCP를 *인체공학적으로* 만듭니다 — 한 번 발견하면 즉시 호출하고, 에이전트용 CLI를 생성하며, 깔끔한 타입 코드를 작성할 수 있습니다. 궁극의 MCP 스위스 아미 나이프입니다.

## 링크

- GitHub: [steipete/mcporter](https://github.com/steipete/mcporter)
- 웹사이트: [mcporter.dev](https://mcporter.dev)
- CLI 참조 및 문서: [github.com/steipete/mcporter/tree/main/docs](https://github.com/steipete/mcporter/tree/main/docs)

어떤 MCP 기반 AI 워크플로우에도 완벽한 동반자입니다.

## Tags

- mcp
- typescript
- cli
- mcp-client
- ai-에이전트
- 도구-호출
- 코드 생성
- 런타임
- claude
- cursor
- context7

## Sources

- [Project website](https://github.com/steipete/mcporter)