고급 프로토콜 기능을 갖춘 종합적인 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)를 제공합니다.

프로젝트 루트에서 편리한 셸(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 기반 코드베이스 분석
...

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', {
...