개요

mcporter (MCPorter 🧳)는 모델 컨텍스트 프로토콜(MCP)을 위한 오픈소스 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 호출로 대체합니다.

설치 및 빠른 시작

즉시 실행 (설치 없음)

npx mcporter list
npx mcporter list linear --schema

전역 설치

npm install -g mcporter
# 또는 Homebrew
brew tap steipete/tap && brew install steipete/tap/mcporter

호출 예제

# 콜론 구문
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 참조 및 예제는 저장소에서 확인하세요.

왜 mcporter인가요?

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

링크

• GitHub: steipete/mcporter
• 웹사이트: mcporter.dev
• CLI 참조 및 문서: github.com/steipete/mcporter/tree/main/docs

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