hackaton-mcp-server
Verified Safeby eatikrh
Overview
A production-ready template for developing Model Context Protocol (MCP) servers, enabling AI agents to use specialized tools for arithmetic, code review prompt generation, resource handling, and backend service querying, with integrated Slack bot support via Keycloak OAuth.
Installation
podman run -p 8080:8080 --env-file .env template-mcp-serverEnvironment Variables
- MCP_PORT
- MCP_TRANSPORT_PROTOCOL
- ENABLE_AUTH
- SSO_CLIENT_ID
- SSO_CLIENT_SECRET
- SSO_INTROSPECTION_URL
- SESSION_SECRET
- PYTHON_LOG_LEVEL
- POSTGRES_HOST
- POSTGRES_PORT
- POSTGRES_DB
- POSTGRES_USER
- POSTGRES_PASSWORD
- MCP_HOST_ENDPOINT
Security Notes
The server offers an `ENABLE_AUTH=false` mode for simplified integrations (e.g., Slack bot demo), explicitly warned as 'not suitable for internet exposure' in documentation. This design shifts authentication responsibility to individual tools or external handling, posing a significant risk if not properly understood and configured. Hardcoded default `MCP_HOST=0.0.0.0` can expose the server if not behind a firewall. Deployment manifests (`secret.yaml`) contain placeholder secrets ('CHANGE_ME') requiring manual updates for production. The `_local_development_token` in `api.py` allows a browser-based OAuth flow for local development, which is a local-only bypass, not a production risk.
Similar Servers
template-mcp-server
Provides a CLI tool and template to quickly get started building a Model Context Protocol (MCP) server using FastMCP, supporting both stdio and HTTP transports.
mcp-python-starter
A feature-complete Model Context Protocol (MCP) server template in Python for developing AI applications and agents.
mcp-server-python-template
This server acts as a template for building Model Context Protocol (MCP) servers in Python, specifically demonstrating how to expose weather-related tools (get_alerts, get_forecast) by integrating with an external API (National Weather Service) to provide context and actions for AI models.
mcp_server
This server template provides a foundation for building Model Context Protocol (MCP) servers to integrate with AI assistants and other MCP clients, offering tools for GitHub, Microsoft Graph, weather data, and JWT decoding.