challenge-mcp

# Challenge MCP [](https://badge.fury.io/py/challenge-mcp) [](https://pypi.org/project/challenge-mcp/) [](https://opensource.org/licenses/MIT) A Model Context Protocol (MCP) server for challenge management with authentication. This package provides a FastMCP server that enables AI assistants to interact with challenge management systems through a standardized protocol. ## Features - 🚀 **FastMCP Server**: Built on the Model Context Protocol for seamless AI integration - 🔐 **Authentication**: Secure token-based authentication system - 🏆 **Challenge Management**: Complete API for managing challenges, participants, and teams - 📊 **Real-time Data**: Server-Sent Events (SSE) support for live updates - 🔧 **Easy Configuration**: Environment-based configuration with sensible defaults ## Installation ### From PyPI (Recommended) ```bash pip install challenge-mcp ``` ### From Source ```bash git clone https://github.com/your-username/challenge-mcp.git cd challenge-mcp pip install -e . ``` ### Development Installation ```bash git clone https://github.com/your-username/challenge-mcp.git cd challenge-mcp pip install -e ".[dev]" ``` ## Quick Start ### 1. Environment Setup Create a `.env` file in your project directory: ```env API_BASE_URL=https://your-api-server.com # Add other environment variables as needed ``` ### 2. Start the Server ```python from challenge_mcp import mcp # Configure if needed mcp.host = "0.0.0.0" mcp.port = 8050 # Start the server mcp.run() ``` ### 3. Health Check Once the server is running, you can check its health: ```bash curl http://localhost:8050/v1/mcp/health ``` ## API Endpoints The server provides several MCP tools for challenge management: ### Challenge Management - `get_active_challenge_list` - Fetch active challenges with…