Klipper MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_CACHE_TTL | No | TTL del cache L1 en segundos | 30 |
| MCP_LOG_LEVEL | No | Nivel de logging (DEBUG…CRITICAL) | INFO |
| PRINTER_VORON | No | URL base de Moonraker para la impresora VORON | |
| MCP_CACHE_DISK | No | Ruta del cache L2 en disco. Vacío = sin L2 | |
| MCP_CACHE_SIZE | No | Nº de entradas del cache L1 en memoria | 512 |
| MCP_CB_RECOVERY | No | Segundos antes de pasar a HALF_OPEN | 30 |
| PRINTER_DEFAULT | No | URL base de Moonraker para la impresora DEFAULT (por defecto http://localhost:7125) | http://localhost:7125 |
| MCP_CACHE_L2_TTL | No | TTL del cache L2 en segundos | 300 |
| MCP_CB_THRESHOLD | No | Fallos consecutivos antes de abrir el circuit breaker | 5 |
| MCP_TOKEN_BUDGET | No | Tokens máximos por respuesta | 4000 |
| MCP_POLL_INTERVAL | No | Intervalo de polling en segundos | 2 |
| MCP_MAX_CONCURRENCY | No | Concurrencia máxima por host (semáforo) | 32 |
| PRINTER_VORON_API_KEY | No | API key opcional para la impresora VORON (cabecera X-Api-Key) | |
| PRINTER_DEFAULT_API_KEY | No | API key opcional para la impresora DEFAULT (cabecera X-Api-Key) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| validate_configC | Valida contenido de configuración Klipper. |
| get_config_fileC | Lee un archivo de configuración. |
| list_config_filesC | Lista archivos de configuración. |
| search_configC | Busca un patrón en todas las configs. |
| lint_extraC | Linter AST de reglas de oro para extras Klipper. |
| generate_extra_templateC | Genera plantilla canónica de extra Klipper. |
| get_server_infoD | Información del servidor Moonraker. |
| list_objectsC | Lista objetos registrados en Klipper. |
| verify_component_loadedC | Verifica que un componente Moonraker esté cargado. |
| verify_extra_loadedC | Verifica que un extra Klipper esté cargado. |
| get_printer_statusC | Consulta estado de objetos de Klipper. |
| get_klippy_logC | Lee las últimas N líneas de klippy.log. |
| detect_anomaliesC | Detecta anomalías en serie con EWMA. |
| get_mcp_telemetryC | Obtiene telemetría de extras MCP (mcp_bridge). |
| run_gcodeC | Ejecuta G-code. Peligrosos requieren confirm=True. |
| restart_klipperC | Reinicia Klipper. Requiere confirm=True. |
| get_print_progressC | Obtiene progreso de impresión. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| troubleshoot_klipper_error | Prompt de diagnóstico de errores de Klipper. |
| diagnose_save_config_conflict | Prompt de diagnóstico de conflictos de SAVE_CONFIG. |
| optimize_printer_config | Prompt de optimización de configuración. |
| review_extra_code | Prompt de revisión de código de extras. |
| generate_extra | Prompt de creación de un extra Klipper. |
| generate_moonraker_component | Prompt de creación de un componente Moonraker. |
| generate_printer_config | Prompt de creación de configuración modular. |
| extension_dev_system_prompt | System prompt del agente Extension Dev. |
| moonraker_dev_system_prompt | System prompt del agente Moonraker Dev. |
| config_engineer_system_prompt | System prompt del agente Config Engineer. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| get_printer_cfg | printer.cfg principal. |
| list_configs | Lista de archivos de configuración. |
| get_klippy_log | Log completo de Klipper. |
| list_docs | Lista de documentos disponibles. |
TDQS
Scored across 17 tools
Most tools target distinct resources and actions (config files, validation, server info, runtime status, logs, G-code execution). However, verify_component_loaded vs verify_extra_loaded and get_printer_status vs list_objects/get_print_progress have somewhat overlapping scopes that could cause occasional misselection.
Tool names consistently use snake_case with a predictable verb_noun pattern (get_*, list_*, verify_*, validate_*, run_*). There is no mixed casing or vague naming, making the set easy to scan.
17 tools is slightly above the ideal range but reasonable for a server covering Klipper config validation, Moonraker diagnostics, telemetry, and printer control. Each tool appears to have a distinct purpose, though the surface is on the heavier side.
The server covers reading, listing, searching, validating configs, plus diagnostics, logs, and basic control. However, it lacks config write/update/delete operations and print lifecycle controls like pause/resume/cancel, leaving some common Klipper management workflows incomplete.