chuk-mcp-server
by chrishayuk
Overview
A framework for building high-performance, modular, zero-configuration Model Context Protocol (MCP) servers, capable of hosting AI agent tools, resources, and prompts across local, containerized, and diverse cloud environments.
Installation
uv run python examples/zero_config_example.pyEnvironment Variables
- GITHUB_TOKEN
- MCP_SERVER_NAME
- MCP_SERVER_VERSION
- MCP_TRANSPORT
- MCP_LOG_LEVEL
- MCP_STDIO
- USE_STDIO
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI
- OAUTH_SERVER_URL
- OAUTH_AUTH_CODE_TTL
- OAUTH_ACCESS_TOKEN_TTL
- OAUTH_REFRESH_TOKEN_TTL
- OAUTH_CLIENT_REGISTRATION_TTL
- OAUTH_EXTERNAL_TOKEN_TTL
- OAUTH_PENDING_AUTH_TTL
- PORT
- DEBUG
- LOG_LEVEL
Security Notes
CRITICAL VULNERABILITY: The default example server provided in `cli.py` (and scaffolded projects) includes a `calculate` tool that uses `eval(expression)`. While there's an attempt to filter allowed characters, `eval` is notoriously difficult to secure against arbitrary code execution, making this a significant remote code execution vulnerability if exposed. NETWORK RISKS: The server defaults to binding on `0.0.0.0` in containerized/cloud environments, which is necessary for platform routing but exposes the server to all network interfaces. This is mitigated by typical cloud infrastructure (load balancers), but direct exposure should be avoided. GOOD PRACTICES: OAuth implementation uses PKCE. Configuration loads environment variables, preventing hardcoded secrets. Relies on `chuk-tool-processor` for robust and resilient MCP handling. Uses `orjson` for fast and potentially safer JSON serialization/deserialization.
Similar Servers
TASK-6-DONE-QUARTER4-MCP-SERVER-AND-github
Implements or proxies the Minecraft Client Protocol (MCP), likely for custom game logic, data interception, or alternative server implementations.
MCPSERVE
A server backend, likely related to the Minecraft Protocol (MCP), intended for game hosting or application services.
scb-mcp-server
Provides backend server functionality, likely related to Minecraft (MCP) protocol interactions or extensions.
mela-cp
This is likely a server or tool related to the Minecraft Client Protocol (MCP), potentially for managing a Minecraft server or developing Minecraft-related applications.