conorluddy/ContextPods: 고급 프로토콜 기능을 갖춘 종합 MCP 개발 스위트

고급 프로토콜 기능을 갖춘 종합적인 MCP 개발 스위트입니다.

Context-Pods는 Model Context Protocol (MCP) 서버를 생성, 테스트 및 관리하기 위한 프로덕션 준비 완료된 (production-ready) 개발 프레임워크입니다. TypeScript로 구축되었으며 TurboRepo를 기반으로 구동됩니다. 기본 템플릿부터 샘플링/LLM 통합, 멀티모달 (multi-modal) 콘텐츠 지원, 리소스 구독 (resource subscriptions), 그리고 종합적인 테스트 프레임워크를 포함한 고급 MCP 프로토콜 기능까지 모든 것을 제공합니다.

# Context-Pods CLI 설치 및 실행
npx @context-pods/create
# 또는 전역 설치
...

선호하는 언어로 MCP 서버를 생성하세요:

TypeScript- TurboRepo 최적화를 통한 완전한 타입 안정성 (type safety)
Python- 내장된 데이터 과학 도구를 활용한 비동기 (Async) 지원
Rust- Tokio 비동기 런타임을 사용한 고성능 서버
Shell- 기존 CLI 도구 및 스크립트를 MCP 서버로 래핑 (wrap)
JavaScript- 빌드 단계가 없는 간단한 서버 (출시 예정)

Meta-MCP 서버는 MCP 프로토콜 자체를 통해 Context-Pods의 기능을 노출하며, 7가지 강력한 도구를 제공합니다:

{
"tools": [
"create-mcp", // 템플릿으로부터 MCP 서버 생성
...

주요 기능:

서버 생성 (Server Generation)- 고급 기능을 갖춘 프로덕션 준비 완료된 MCP 서버 생성
스크립트 래핑 (Script Wrapping)- Python, Shell, TypeScript 및 기타 스크립트 변환
서버 관리 (Server Management)- 기존 MCP 서버 목록화, 검증 및 관리
AI 분석 (AI Analysis)- AST 파싱 및 패턴 탐지를 통한 지능형 코드베이스 분석
레지스트리 시스템 (Registry System)- 메타데이터 추적 기능이 있는 SQLite 기반 서버 레지스트리
템플릿 시스템 (Template System)- TurboRepo 통합이 적용된 5가지 최적화된 템플릿

현대적인 MCP SDK 1.17.4 구현:

Sampling & LLM Integration

• 모델 선호도(model preferences) 및 온도 조절(temperature control)을 포함한 내장 LLM 기능

Multi-Modal Content

• 텍스트, 이미지, 오디오, 비디오 및 임베디드 리소스(embedded resources) 지원

Resource Subscriptions

• 구독 관리(subscription management)를 통한 실시간 리소스 업데이트

Roots Capability

• 샌드박스 액세스(sandboxed access)를 통한 안전한 파일 시스템 탐색

Completion Providers

• 향상된 사용자 경험을 위한 자동 완성(auto-complete) 기능

Progress Notifications

• 실시간 업데이트를 통한 장시간 실행 작업(long-running operation) 추적

Prompt Templates

• 인자(argument) 지원을 통한 동적 프롬프트 관리

Development & Quality Assurance:

AI-Powered Analysis

• 기존 코드베이스에서 MCP 적용 기회를 자동으로 식별

TurboRepo Optimization

• 고급 캐싱(caching), 핫 리로딩(hot reloading) 및 증분 빌드(incremental builds)

Comprehensive Testing

• 패키지 전반에 걸쳐 85-95% 이상의 커버리지를 가진 805개 이상의 테스트

MCP Protocol Compliance

• 공식 MCP 스키마(schemas)에 대한 자동 검증

Quality Gates

• 빌드, 린트(lint), 타입 체크(type-check) 및 테스트 성공을 보장하는 프리 커밋 훅(pre-commit hooks)

Multi-Language Support

• TypeScript, Python, Rust 및 Shell 템플릿

필수 기능을 갖춘 최소한의 TypeScript MCP 서버:

context-pods generate basic --name my-server

비동기(async)를 지원하는 독립형 Python 서버:

context-pods generate python-basic --name my_python_server

Tokio 기반의 고성능 Rust 서버:

context-pods generate rust-basic --name my_rust_server

MCP를 통해 셸 스크립트 및 CLI 도구 노출:

context-pods generate shell-wrapper --name my_cli_wrapper

완전한 MCP SDK 1.17.4 기능 구현을 포함한 프로덕션 준비 완료 TypeScript 서버:

Advanced MCP Protocol Features:

Sampling & LLM Integration

• 구성 가능한 모델을 갖춘 내장형 AI 기능
  Multi-Modal Content
• 텍스트, 이미지, 오디오, 비디오 및 임베디드 리소스 지원
  Resource Subscriptions
• 구독 관리를 통한 실시간 업데이트
  Roots Capability
• 보안 샌드박스 파일 시스템 액세스
  Completion Providers
• 자동 완성 (Auto-complete) 기능
  Progress Notifications
• 장시간 실행되는 작업 추적
  Prompt Templates
• 동적 프롬프트 관리 시스템

Development Features:

TurboRepo Optimization

• 핫 리로딩 (Hot reloading) 및 지능형 캐싱
  Comprehensive Utilities
• 데이터 검증, 파일 작업, 에러 핸들링
  Advanced Tools
• 파일, 데이터 및 유틸리티 도구 카테고리
  Schema Validation
• Zod 기반의 런타임 검증
  Structured Logging
• Context-Pods 로거를 사용한 프로덕션 준비 완료 로깅
  Testing Ready
• 내장된 테스트 구조 및 MCP 준수 검증

context-pods generate typescript-advanced --name my-advanced-server

Context-Pods에는 기존 코드에서 훌륭한 MCP 도구가 될 수 있는 함수를 식별하는 지능형 코드베이스 분석기 (codebase analyzer)가 포함되어 있습니다. 이 기능은 MCP 활용 기회를 발견하도록 돕고 구현 가이드를 제공합니다.

분석기는 다음과 같은 다단계 접근 방식을 사용합니다:

File Discovery

• 지능형 필터링을 통한 코드베이스 재귀적 스캔
  AST Parsing
• 언어별 파서를 사용한 함수 메타데이터 추출
  Pattern Detection
• MCP에 적합한 패턴 (API 호출, 파일 작업 등) 식별
  Scoring Algorithm
• 정교한 점수 시스템 (0-100)을 사용한 함수 순위 지정
  Template Matching
• 각 기회에 가장 적합한 템플릿 제안

TypeScript/JavaScript

• 타입 정보를 포함한 전체 AST 분석
  Python
• AST 기반 함수 추출 (출시 예정)
  Rust/Go
• 패턴 기반 분석 (계획 중)
  Shell
• 스크립트 패턴 탐지 (계획 중)

# 기본 분석
context-pods analyze ./src
# 필터링 및 출력 옵션 포함
...

{
"tool": "analyze-codebase",
"arguments": {
...

분석기는 다음과 같은 기능을 가진 함수를 식별합니다:

API 통합 패턴 (API Integration Patterns)

• HTTP 클라이언트, REST 호출, GraphQL 쿼리
  파일 처리 작업 (File Processing Operations)
• 파일 I/O, 데이터 변환, 파싱
  데이터베이스 상호작용 (Database Interactions)
• SQL 쿼리, ORM 작업, 데이터 검증
  유틸리티 함수 (Utility Functions)
• 데이터 검증, 포맷팅, 변환
  외부 서비스 통합 (External Service Integrations)
• 제3자 API 사용

함수는 다음 기준에 따라 점수가 매겨집니다:

복잡도 (Complexity)

• 중간 정도의 복잡도(순환 복잡도(Cyclomatic Complexity) 3-15)가 최적임
  접근성 (Accessibility)
• 내보내기(Exported)된 함수가 더 높은 점수를 받음
  문서화 (Documentation)
• 문서화가 잘 된 함수를 선호함
  매개변수 (Parameters)
• 명확한 입력 매개변수(1-5개의 매개변수가 최적)
  패턴 (Patterns)
• 감지된 MCP 적합 패턴이 점수를 높임
  비동기 특성 (Async Nature)
• 비동기(Async) 함수는 종종 유용한 I/O 작업을 수행함

🎯 발견된 상위 MCP 기회 (점수: 85+)
📁 src/api/weather.ts
└── fetchWeatherData (점수: 92/100)
...

Context-Pods는 11개의 명령어, 강화된 대화형 기능 및 광범위한 도움말 문서를 포함하는 종합적인 명령줄 인터페이스(CLI)를 제공합니다.

명령어	목적	주요 기능
generate	템플릿으로부터 MCP 서버 생성	5개의 템플릿, 대화형 선택, MCP 설정 생성
wrap	스크립트를 MCP 서버로 변환	자동 감지, Python/Shell/TS/JS 지원
init	프로젝트 설정 초기화	대화형 설정, 템플릿 기본 설정
list	MCP 서버 관리	활성/비활성 상태, JSON 출력
templates	사용 가능한 템플릿 탐색	내장 및 사용자 정의 템플릿, 상세 정보
wizard	대화형 가이드 설정	단계별 서버 생성, 모든 기능
doctor	시스템 상태 진단	종속성 체크, 문제 자동 수정
dev	개발 모드	핫 리로딩(Hot reloading), 사용자 정의 포트, 파일 감시
build	패키지 빌드	클린 빌드, TurboRepo 최적화
test	테스트 스위트 실행	커버리지 보고서, 워치 모드(Watch mode), 805개 이상의 테스트
server	메타-MCP 서버 관리	시작/중지/상태, 개발 모드

프로젝트 루트에서 편리한 셸(shell) 바로가기를 사용하세요:

# 전체 명령어를 입력하지 않고 빠르게 접근
./pods --help
./pods generate typescript-basic --name my-server
...

또는 전체 CLI를 사용하세요:

npx @context-pods/cli <command>
context-pods <command> # 전역(globally) 설치된 경우

# 대화형 템플릿 선택
context-pods generate
# 특정 템플릿으로 빠른 생성
...

옵션(Options):

-n, --name <name>

• MCP 서버 이름 (필수)
  -o, --output <path>

• 출력 디렉토리(Output directory)
  -d, --description <text>

• 서버 설명
  -f, --force

• 기존 파일 덮어쓰기
  --var <key=value...>

• 템플릿 변수(Template variables)
  --generate-mcp-config

• .mcp.json 설정 파일 생성
  --config-name <name>

• MCP 설정 이름
  --command <command>

• 서버 실행 명령어
  --env <key=value...>

• 환경 변수(Environment variables)

# 기본 스크립트 래핑(wrapping)
context-pods wrap ./my-script.py --name python-tools
# 사용자 정의 출력 위치 지정
...

지원되는 스크립트 유형(Supported Script Types):

• Python (.py) - 비동기(async) MCP 래퍼 생성
• Shell (.sh, .bash) - 커맨드 라인(Command-line) MCP 인터페이스
• JavaScript (.js, .mjs) - Node.js MCP 래퍼
• TypeScript (.ts) - 트랜스파일(Transpiled)된 MCP 래퍼
• 실행 파일(Executable files) - 범용 커맨드 라인 래퍼

옵션(Options):

-n, --name <name>

• MCP 서버 이름 (필수)
  -t, --template <name>

• 사용할 템플릿 (자동 감지)
  -o, --output <path>

• 출력 디렉토리
  -d, --description <text>

• 서버 설명
  -f, --force

• 기존 파일 덮어쓰기

# 활성화된 MCP 서버 표시
context-pods list
# 비활성 서버를 포함한 모든 서버 표시
...

# 사용 가능한 템플릿 표시
context-pods templates
# 사용자 정의 템플릿을 포함한 모든 템플릿 표시
...

# 대화형 프로젝트 설정
context-pods init
# 이름 지정으로 빠른 설정
...

# 모든 상태 점검(health checks) 실행
context-pods doctor
# 상세 정보
...

상태 점검(Health Checks):

• Node.js 및 npm 버전
• 워크스페이스 (Workspace) 구조 무결성
• 패키지 빌드 (Build) 상태
• 템플릿 (Template) 가용성
• Git 저장소 (Repository) 상태
• 의존성 (Dependencies) 설치 상태
• MCP 서버 기능성

# 전체 대화형 위저드 (Wizard)
context-pods wizard
# 환영 메시지 건너뛰기
...

위저드 (Wizard) 기능:

서버 생성 (Server Generation)

• 언어 선호도가 반영된 가이드형 템플릿 선택
  스크립트 래핑 (Script Wrapping)
• 단계별 스크립트 변환
  프로젝트 초기화 (Project Initialization)
• 대화형 구성 (Configuration) 설정
  템플릿 탐색기 (Template Explorer)
• 사용 가능한 템플릿 탐색 및 미리보기
  고급 옵션 (Advanced Options)
• 사용자 정의 변수, 출력 경로 및 구성

# 개발 서버 시작
context-pods dev
# 사용자 정의 포트
...

# 모든 패키지 빌드
context-pods build
# 클린 빌드 (Clean build)
...

# 모든 테스트 실행
context-pods test
# 커버리지 (Coverage) 포함
...

# 모든 캐시 삭제
context-pods cache clear
# 캐시 통계 표시
...

# Meta-MCP 서버 시작
context-pods server start
# 개발 모드
...

# 현재 구성 표시
context-pods config show
# 기본값으로 초기화
...

# 기본 분석
context-pods analyze ./src
# 가치 높은 기회만 표시
...

# 기본 검증
context-pods validate ./my-server
# 빌드를 포함한 전체 검증
...

모든 명령어에는 예시가 포함된 종합적인 도움말이 제공됩니다:

# 글로벌 도움말
context-pods --help
# 명령어별 도움말
...

./pods 단축 명령어는 색상과 진행 표시줄이 포함된 강화된 출력을 제공합니다:

./pods # 사용법 도움말 표시
./pods doctor # 시스템 진단
./pods wizard # 대화형 설정
...

다른 도구와의 통합을 위해 JSON 출력을 사용할 수 있습니다:

# 서버 목록을 JSON으로 가져오기
context-pods list --format json | jq '.servers[] | .name'
# 템플릿 정보 가져오기
...

Context-Pods는 최적화된 캐싱 및 빌드 파이프라인을 갖춘 TurboRepo 모노레포 (Monorepo) 구조를 사용합니다:

context-pods/
├── packages/
│ ├── core/ # 핵심 유틸리티, 스키마 (Schemas) 및 AI 기반 코드베이스 분석
...

패키지 (Package)	목적 (Purpose)	주요 기능 (Key Features)	테스트 커버리지 (Test Coverage)
@context-pods/core	핵심 엔진 및 분석	템플릿 처리, AI 코드베이스 분석, 스키마 검증 (Schema validation)	160개 테스트, 90%+
@context-pods/cli	명령줄 인터페이스 (CLI)	11개 명령어, 대화형 위저드 (Interactive wizards), TurboRepo 통합	251개 테스트, 90%+
@context-pods/server	Meta-MCP 서버	7개 도구 (Tools), 서버 레지스트리, MCP 프로토콜 구현	285개 테스트, 95%+
@context-pods/templates	템플릿 컬렉션	5개 언어, 고급 MCP 기능, 프로덕션 준비 완료 (Production-ready)	91개 테스트, 85%+
@context-pods/testing	테스트 프레임워크	프로토콜 준수 (Protocol compliance), 래퍼 테스트 (Wrapper testing), 보고서 생성	프레임워크 준비 완료
@context-pods/create	패키지 러너 (Package runner)	npx 통합, 의존성 관리, CLI 부트스트래핑 (Bootstrapping)	22개 테스트, 75%+

Claude Desktop 설정에 추가하세요:

{
"mcpServers": {
"context-pods": {
...

확장 프로그램(Extension) 설정에서 구성하세요:

{
"mcp.servers": {
"context-pods": {
...

Context-Pods는 모든 패키지에 걸쳐 805개 이상의 테스트를 포함하는 포괄적인 테스트 프레임워크를 제공합니다:

공식 MCP 사양에 따라 서버를 검증하세요:

import {
MCPComplianceTestSuite,
validateMCPServer,
...

여러 언어에 걸쳐 래핑된 스크립트를 테스트하세요:

import { testScriptWrapper } from '@context-pods/testing';
// Python 스크립트 래퍼 테스트
const pythonResults = await testScriptWrapper('./script.py', {
...