Supports deployment of MCP servers to AWS Lambda serverless functions
Provides test coverage reporting and metrics tracking for MCP server development
Supports containerized deployment of MCP servers using Docker
Provides code linting and quality assurance for TypeScript and JavaScript MCP servers
Integrates with Git repositories for version control and project management of MCP servers
Provides GitHub integration for repository management, CI/CD, and code collaboration
Supports GraphQL transport protocol for MCP server communication
Generates and manages JavaScript-based MCP servers with Node.js runtime support
Provides IDE integration for enhanced MCP development experience in JetBrains IDEs
Supports Node.js runtime for JavaScript and TypeScript MCP server execution
Manages package dependencies and publishing for MCP servers through npm registry
Generates and manages Python-based MCP servers with async support and data science tools
Generates high-performance Rust-based MCP servers with Tokio async runtime
Wraps existing shell scripts and CLI tools as MCP servers for command-line integration
Provides lightweight database functionality for MCP server registry management and metadata tracking
Utilizes TurboRepo for monorepo management, intelligent caching, and optimized build pipelines
Generates type-safe TypeScript MCP servers with comprehensive MCP protocol implementation
Supports deployment of MCP servers to Vercel's serverless platform
Provides comprehensive testing framework for MCP protocol compliance and server validation
Implements runtime type validation and schema generation for MCP server data structures
Context-Pods
The comprehensive MCP development suite with advanced protocol features
Context-Pods is a production-ready development framework for creating, testing, and managing Model Context Protocol (MCP) servers. Built with TypeScript and powered by TurboRepo, it provides everything from basic templates to advanced MCP protocol features including sampling/LLM integration, multi-modal content support, resource subscriptions, and comprehensive testing frameworks.
🚀 Quick Start
✨ Features
🎯 Multiple Language Support
Create MCP servers in your preferred language:
- TypeScript - Full type safety with TurboRepo optimization
- Python - Async support with built-in data science tools
- Rust - High-performance servers with Tokio async runtime
- Shell - Wrap existing CLI tools and scripts as MCP servers
- JavaScript - Simple, no-build-step servers (coming soon)
🤖 Meta-MCP Server
The Meta-MCP Server exposes Context-Pods functionality through the MCP protocol itself, providing 7 powerful tools:
Key Features:
- Server Generation - Create production-ready MCP servers with advanced features
- Script Wrapping - Convert Python, Shell, TypeScript, and other scripts
- Server Management - List, validate, and manage existing MCP servers
- AI Analysis - Intelligent codebase analysis with AST parsing and pattern detection
- Registry System - SQLite-based server registry with metadata tracking
- Template System - 5 optimized templates with TurboRepo integration
🛠️ Advanced MCP Protocol Features
Modern MCP SDK 1.17.4 Implementation:
- Sampling & LLM Integration - Built-in LLM capabilities with model preferences and temperature control
- Multi-Modal Content - Support for text, images, audio, video, and embedded resources
- Resource Subscriptions - Real-time resource updates with subscription management
- Roots Capability - Secure file system navigation with sandboxed access
- Completion Providers - Auto-complete functionality for enhanced user experience
- Progress Notifications - Long-running operation tracking with real-time updates
- Prompt Templates - Dynamic prompt management with argument support
Development & Quality Assurance:
- AI-Powered Analysis - Automatically identify MCP opportunities in existing codebases
- TurboRepo Optimization - Advanced caching, hot reloading, and incremental builds
- Comprehensive Testing - 805+ tests across packages with 85-95%+ coverage
- MCP Protocol Compliance - Automated validation against official MCP schemas
- Quality Gates - Pre-commit hooks ensuring build, lint, type-check, and test success
- Multi-Language Support - TypeScript, Python, Rust, and Shell templates
📦 Templates
Basic Templates
basic
(TypeScript)
Minimal TypeScript MCP server with essential features:
python-basic
Self-contained Python server with async support:
rust-basic
High-performance Rust server with Tokio:
shell-wrapper
Expose shell scripts and CLI tools via MCP:
Advanced Templates
typescript-advanced
Production-ready TypeScript server with complete MCP SDK 1.17.4 feature implementation:
Advanced MCP Protocol Features:
- Sampling & LLM Integration - Built-in AI capabilities with configurable models
- Multi-Modal Content - Text, image, audio, video, and embedded resource support
- Resource Subscriptions - Real-time updates with subscription management
- Roots Capability - Secure sandboxed file system access
- Completion Providers - Auto-complete functionality
- Progress Notifications - Long-running operation tracking
- Prompt Templates - Dynamic prompt management system
Development Features:
- TurboRepo Optimization - Hot reloading and intelligent caching
- Comprehensive Utilities - Data validation, file operations, error handling
- Advanced Tools - File, data, and utility tool categories
- Schema Validation - Zod-based runtime validation
- Structured Logging - Production-ready logging with Context-Pods logger
- Testing Ready - Built-in test structure and MCP compliance validation
🤖 AI-Powered Codebase Analysis
Context-Pods includes an intelligent codebase analyzer that identifies functions in your existing code that would make excellent MCP tools. This feature helps you discover MCP opportunities and provides implementation guidance.
How It Works
The analyzer uses a multi-phase approach:
- File Discovery - Recursively scans your codebase with intelligent filtering
- AST Parsing - Extracts function metadata using language-specific parsers
- Pattern Detection - Identifies MCP-suitable patterns (API calls, file operations, etc.)
- Scoring Algorithm - Ranks functions using a sophisticated scoring system (0-100)
- Template Matching - Suggests the best template for each opportunity
Supported Languages
- TypeScript/JavaScript - Full AST analysis with type information
- Python - AST-based function extraction (coming soon)
- Rust/Go - Pattern-based analysis (planned)
- Shell - Script pattern detection (planned)
Usage Examples
Via Meta-MCP Server
What It Detects
The analyzer identifies functions with:
- API Integration Patterns - HTTP clients, REST calls, GraphQL queries
- File Processing Operations - File I/O, data transformation, parsing
- Database Interactions - SQL queries, ORM operations, data validation
- Utility Functions - Data validation, formatting, conversion
- External Service Integrations - Third-party API usage
Scoring Factors
Functions are scored based on:
- Complexity - Sweet spot is medium complexity (3-15 cyclomatic complexity)
- Accessibility - Exported functions score higher
- Documentation - Well-documented functions are preferred
- Parameters - Clear input parameters (1-5 params optimal)
- Patterns - Detected MCP-suitable patterns boost scores
- Async Nature - Async functions often perform useful I/O operations
Sample Output
🔧 CLI Commands
Context-Pods provides a comprehensive command-line interface with 11 commands, enhanced interactive features, and extensive help documentation.
Complete Command Overview
Command | Purpose | Key Features |
---|---|---|
generate | Create MCP servers from templates | 5 templates, interactive selection, MCP config generation |
wrap | Convert scripts to MCP servers | Auto-detection, Python/Shell/TS/JS support |
init | Initialize project configuration | Interactive setup, template preferences |
list | Manage MCP servers | Active/inactive status, JSON output |
templates | Explore available templates | Built-in and custom templates, detailed info |
wizard | Interactive guided setup | Step-by-step server creation, all features |
doctor | System health diagnostics | Dependency checks, auto-fix issues |
dev | Development mode | Hot reloading, custom ports, file watching |
build | Build packages | Clean builds, TurboRepo optimization |
test | Run test suites | Coverage reports, watch mode, 805+ tests |
server | Meta-MCP server management | Start/stop/status, development mode |
Quick Access
Use the convenient shell shortcut from the project root:
Or use the full CLI:
Core Commands
🎯 generate - Create MCP servers from templates
Options:
-n, --name <name>
- MCP server name (required)-o, --output <path>
- Output directory-d, --description <text>
- Server description-f, --force
- Overwrite existing files--var <key=value...>
- Template variables--generate-mcp-config
- Generate .mcp.json config--config-name <name>
- Name for MCP config--command <command>
- Run command for server--env <key=value...>
- Environment variables
🔧 wrap - Convert existing scripts to MCP servers
Supported Script Types:
- Python (
.py
) - Creates async MCP wrapper - Shell (
.sh
,.bash
) - Command-line MCP interface - JavaScript (
.js
,.mjs
) - Node.js MCP wrapper - TypeScript (
.ts
) - Transpiled MCP wrapper - Executable files - Generic command-line wrapper
Options:
-n, --name <name>
- MCP server name (required)-t, --template <name>
- Template to use (auto-detected)-o, --output <path>
- Output directory-d, --description <text>
- Server description-f, --force
- Overwrite existing files
📋 list - Manage MCP servers
📚 templates - Explore available templates
⚙️ init - Initialize project configuration
🏥 doctor - System health checks and diagnostics
Health Checks:
- Node.js and npm versions
- Workspace structure integrity
- Package build status
- Template availability
- Git repository status
- Dependencies installation
- MCP server functionality
🧙♂️ wizard - Interactive guided setup
Wizard Features:
- Server Generation - Guided template selection with language preferences
- Script Wrapping - Step-by-step script conversion
- Project Initialization - Interactive configuration setup
- Template Explorer - Browse and preview available templates
- Advanced Options - Custom variables, output paths, and configurations
Development Commands
🚀 dev - Development mode with hot reloading
🔨 build - Build packages
🧪 test - Run tests
Management Commands
💾 cache - Cache management
🖥️ server - Meta-MCP Server management
⚙️ config - Configuration management
Advanced Features
📊 analyze - AI-powered codebase analysis
✅ validate - MCP compliance validation
Help and Documentation
Every command includes comprehensive help with examples:
Shell Integration
The ./pods
shortcut provides enhanced output with colors and progress indicators:
Scripting and Automation
Use JSON output for integration with other tools:
🏗️ Architecture
Context-Pods uses a TurboRepo monorepo structure with optimized caching and build pipelines:
Package Overview
Package | Purpose | Key Features | Test Coverage |
---|---|---|---|
@context-pods/core | Core engine and analysis | Template processing, AI codebase analysis, schema validation | 160 tests, 90%+ |
@context-pods/cli | Command-line interface | 11 commands, interactive wizards, TurboRepo integration | 251 tests, 90%+ |
@context-pods/server | Meta-MCP server | 7 tools, server registry, MCP protocol implementation | 285 tests, 95%+ |
@context-pods/templates | Template collection | 5 languages, advanced MCP features, production-ready | 91 tests, 85%+ |
@context-pods/testing | Testing framework | Protocol compliance, wrapper testing, report generation | Framework ready |
@context-pods/create | Package runner | npx integration, dependency management, CLI bootstrapping | 22 tests, 75%+ |
🔌 Integration
Claude Desktop
Add to your Claude Desktop configuration:
VS Code (Cody, Continue)
Configure in your extension settings:
🧪 Testing Framework
Context-Pods includes a comprehensive testing framework with 805+ tests across all packages:
MCP Protocol Compliance Testing
Validate servers against official MCP specifications:
Script Wrapper Testing
Test wrapped scripts across multiple languages:
Test Categories
- Unit Tests - Individual function and class testing (599+ tests)
- Integration Tests - End-to-end workflow validation (156+ tests)
- Protocol Compliance - MCP specification adherence (50+ tests)
- Template Validation - Generated code quality assurance
- Performance Tests - Scalability and resource usage benchmarks
- Error Handling - Resilience and recovery testing
📚 Documentation
🧪 Test Coverage & Quality Assurance
Context-Pods maintains exceptional test coverage with 805+ total tests across all packages:
Coverage by Package
Package | Coverage | Tests | Focus Areas |
---|---|---|---|
@context-pods/server | 95%+ | 285 | MCP protocol implementation, tools, registry, validation |
@context-pods/cli | 90%+ | 251 | All 11 CLI commands, caching, TurboRepo integration |
@context-pods/core | 90%+ | 160 | Template engine, AI analysis, schema validation |
@context-pods/templates | 85%+ | 91 | Template validation, MCP feature coverage, SDK compliance |
@context-pods/create | 75%+ | 22 | NPX runner, dependency management, error handling |
@context-pods/testing | Framework | Ready | MCP compliance testing, wrapper validation |
Test Categories
- Unit Tests - Individual function and class testing
- Integration Tests - End-to-end workflow validation
- Protocol Compliance - MCP specification adherence
- Template Validation - Generated code quality assurance
- Error Handling - Resilience and recovery testing
- Performance Tests - Scalability and resource usage
Quality Gates & Standards
All quality gates must pass before any commit:
- Build (
npm run build
) - All 6 packages compile successfully - Type Check (
npm run type-check
) - Strict TypeScript validation - Lint (
npm run lint
) - Zero ESLint errors across all files - Format (
npm run format
) - Consistent code formatting - Test (
npm run test
) - All 805+ tests pass
Additional Quality Features:
- TurboRepo Caching - Intelligent build and test result caching
- Pre-commit Hooks - Automated quality gate enforcement
- MCP Protocol Validation - Schema compliance testing against official specs
- Template Integrity - Generated code quality assurance
- Performance Benchmarks - Build time and execution optimization
Run tests locally:
Development Setup
Quality Development Commands:
📈 Roadmap
Current Status: Production-ready MCP development framework with advanced protocol features
Upcoming Enhancements:
- Additional Language Templates - Go, Ruby, Java support
- Visual Template Builder - Web-based template customization interface
- MCP Server Marketplace - Community template and server sharing
- Cloud Deployment - AWS Lambda, Vercel, and Docker deployment options
- Advanced Analytics - Performance profiling and usage analytics
- Extended Transport Support - HTTP, WebSocket, and GraphQL transports
- IDE Extensions - VS Code, JetBrains integration for enhanced developer experience
Recently Completed (v0.1.10):
- ✅ MCP SDK 1.17.4 - Full modern MCP protocol implementation
- ✅ Advanced Protocol Features - Sampling, multi-modal, subscriptions, roots, completion
- ✅ Comprehensive Testing - 805+ tests with 85-95%+ coverage across packages
- ✅ Quality Gates - Pre-commit hooks, automated CI/CD, strict TypeScript
- ✅ AI-Powered Analysis - Intelligent codebase analysis with AST parsing
- ✅ TurboRepo Optimization - Advanced caching, hot reloading, incremental builds
📄 License
MIT © Conor Luddy
🙏 Acknowledgments
Built with the Model Context Protocol SDK v1.17.4 by Anthropic.
Core Technologies:
- TypeScript - Type-safe development with strict compiler settings
- TurboRepo - Advanced monorepo management with intelligent caching
- Vitest - Fast, modern testing framework with comprehensive coverage
- Zod - Runtime type validation and schema generation
- SQLite - Lightweight database for server registry management
📊 Project Stats
- Total Lines of Code: 25,000+ (production code)
- Test Files: 805+ comprehensive tests across all packages
- Templates: 5 production-ready templates (TypeScript, Python, Rust, Shell)
- CLI Commands: 11 comprehensive commands with interactive wizards
- MCP Tools: 7 powerful tools in the Meta-MCP server
- Documentation: 12+ comprehensive guides and API references
- Quality Gates: 5 automated checks (build, type-check, lint, format, test)
This server cannot be installed
Context-Pods is a comprehensive development framework for creating, testing, and managing Model Context Protocol (MCP) servers. It provides a Meta-MCP Server that can generate other MCP servers through natural language descriptions or by wrapping existing scripts.
Related MCP Servers
- AsecurityAlicenseAqualityModel Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for Upstash Developer API's.Last updated -7449MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides Pokémon information by connecting to the PokeAPI, enabling users to query detailed Pokémon data, discover random Pokémon, and find Pokémon by region or type.Last updated -49MIT License
RunPod MCP Serverofficial
-securityAlicense-qualityThis Model Context Protocol server enables interaction with RunPod's REST API through Claude or other MCP-compatible clients, providing tools for managing pods, endpoints, templates, network volumes, and container registry authentications.Last updated -20MIT License- -securityFlicense-qualityA lightweight Model Context Protocol server that enables creating, managing, and querying model contexts with integrated Datadog metrics and monitoring.Last updated -