MCP Kernel - Model Context Protocol HTTP Server Development Environment

A centralized testing and development environment for MCP (Model Context Protocol) HTTP servers using FastMCP.

Overview

This repository contains 19 HTTP-based MCP servers converted from various sources to use the FastMCP framework. It serves as a kernel for testing and developing MCP servers before deploying them to production environments.

Features

• 19 HTTP MCP Servers - All running on separate ports (8003-8026)
• FastMCP Framework - Modern async Python implementation
• Improved Error Handling - Graceful fallbacks and simulations
• Auto-Setup Capabilities - Automatic project structure detection
• Management Scripts - Easy server startup and configuration

Servers Included

Phase 1: Core Services

• Brave Search (8003) - Web search capabilities
• Filesystem (8006) - File system operations
• Memory (8007) - Persistent memory storage

Phase 2: AI/Development Services

• Vercel v0 (8010) - AI component generation
• GitHub (8011) - Repository management
• OpenAI Tools (8012) - OpenAI API integration
• Supabase (8013) - Database operations
• Gemini (8014) - Google AI integration
• Anthropic Comprehensive (8015) - Claude API tools
• Sequential Thinking (8016) - Step-by-step reasoning

Phase 3: External Integrations

• Slack (8017) - Slack messaging
• Redis (8018) - Redis cache operations
• Context7 (8019) - Documentation search

Phase 4: Automation/Infrastructure

• Docker (8020) - Container management
• Everything (8021) - Universal operations
• Fetch (8022) - HTTP requests
• Browserbase (8023) - Browser automation
• Hostinger (8024) - Hosting operations
• Vercel Deploy (8025) - Deployment automation
• Routing (8026) - Request routing

Setup

1. Clone the repository
2. Create a virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Copy .env.example to .env and add your API keys
5. Start servers using the management script:

   ./mcp-servers/manage_mcp_servers.sh start

Configuration

Configure Claude to use these HTTP servers:

./mcp-servers/manage_mcp_servers.sh reset

Recent Improvements

• Fixed GitHub server parameter handling for None values
• Enhanced Supabase error handling with graceful fallbacks
• Improved v0 server with automatic project setup
• Better code extraction and markdown parsing
• Management script improvements to avoid session conflicts

Development

This is a testing kernel - changes should be tested here before deploying to production environments like devloop3.

License

MIT