MCP2SKILL은(는) 무엇을 하나요?
로컬 MCP 서버 소스 코드(TypeScript/JavaScript 또는 Python)를 실행 가능한 Claude Code SKILL 패키지로 변환합니다. MCP를 SKILL로 전환하고, SKILL.md + scripts + references를 자동 생성하며, 도구 매개변수와 구현을 추출하여 독립 스크립트를 출력하는 데 적합합니다.
개요
MCP2SKILL은 MCP(Model Context Protocol) 서버의 소스 코드를 분석하여, 각 도구(tool)를 Claude Code에서 사용 가능한 SKILL 형식으로 변환합니다. 이를 통해 기존 MCP 에코시스템의 도구들을 Claude Code 워크플로우에 손쉽게 통합할 수 있습니다.
지원 언어
- TypeScript / JavaScript (
import문법 사용) - Python
주요 기능
- MCP 서버 소스 코드에서 도구 정의 및 구현 추출
- 각 도구에 대한 독립 실행 스크립트 생성 (
scripts/디렉토리) - 자동으로
SKILL.md문서 생성 (도구 설명, 매개변수, 사용 예시 포함) - 참조 파일 생성 (
references/디렉토리) - TypeScript의 경우
tsc를 사용한 컴파일 지원
사용 방법
- 변환할 MCP 서버 소스 파일을 준비합니다.
- 다음 명령어를 실행합니다:
# TypeScript MCP 서버 변환
mcp2skill ./path/to/mcp-server.ts
# Python MCP 서버 변환
mcp2skill ./path/to/mcp-server.py
- 생성된
SKILL.md파일과scripts/,references/디렉토리를 확인합니다.
출력 구조
output/
├── SKILL.md # 스킬 문서
├── scripts/ # 각 도구의 독립 실행 스크립트
│ ├── tool1.sh
│ └── tool2.sh
└── references/ # 참조 파일
└── ...
예시
MCP 서버 예시 (math-server.py):
def add(a: int, b: int) -> int:
"""두 숫자를 더합니다."""
return a + b
변환 후 생성된 스크립트 (scripts/add.sh):
#!/bin/bash
# 두 숫자를 더합니다.
# 매개변수:
# a (int): 첫 번째 숫자
# b (int): 두 번째 숫자
python3 -c "
import sys
sys.path.insert(0, '.')
from math_server import add
a = int(sys.argv[1])
b = int(sys.argv[2])
print(add(a, b))
" "$@"
요구 사항
- Node.js 18+ (TypeScript 변환 시)
- Python 3.8+ (Python 변환 시)
- Claude Code CLI 도구
제한 사항
- 동적 임포트나 복잡한 의존성 그래프는 완전히 지원되지 않을 수 있습니다.
- 외부 API 호출이 포함된 도구의 경우, 변환 후 환경 변수 설정이 필요할 수 있습니다.
라이선스
MIT