Repository navigation
Releases
Releases · rtostudioco/universal-mcp
v0.2.0 — Security & Reliability
Universal MCP 0.2.0 — Security & Reliability
Release de estabilización: cierra la superficie de seguridad pendiente y endurece el núcleo antes de sumar funcionalidad nueva.
🔒 Seguridad
- Anti-SSRF por hop en redirecciones (
automation_http_request,automation_send_webhook):follow_redirects=False+ bucle manual que re-valida cada destino (Location absolutas y relativas, límite de 5 saltos, degradación 301/302/303 → GET con descarte de cuerpo; 307/308 conservan método y cuerpo). Elimina el bypass clásico302 → http://169.254.169.254/y reduce el DNS rebinding. - Permisos por herramienta:
MCP_ALLOWED_TOOLS/MCP_BLOCKED_TOOLS(globs sobre el nombre final; blocked siempre gana).- Registro: una tool no permitida no se registra (se reporta en
RegistrationReport.blocked_tools); el resto del módulo sigue vivo. - Runtime: guard que lanza
SecurityViolationErrorsi la política bloquea la tool.
- Registro: una tool no permitida no se registra (se reporta en
🛡️ Fiabilidad
- Sin registro parcial: si un módulo falla a mitad de registro, sus tools/prompts/resources a medias se revierten (rollback vía snapshot de FastMCP +
remove_tool) y los nombres quedan libres. - Ciclo de vida completo:
shutdown()invocateardown()en orden inverso, idempotente y tolerante a fallos; conectado a SIGINT/SIGTERM/SIGHUP yatexit.
🧪 Calidad
- Suite ampliada 46 → 75 pruebas (nuevo
tests/test_security.py): redirecciones maliciosas, política de permisos, rollback parcial, lifecycle. - CI con Python 3.13: matriz 3.10 / 3.11 / 3.12 / 3.13.
- Docs:
CHANGELOG.md, modelo de seguridad en README, notas v0.2 endocs/.
⬇️ Instalación
pip install universal-mcp==0.2.0
# o desde el wheel adjunto:
pip install universal_mcp-0.2.0-py3-none-any.whlNota: los plugins externos siguen desactivados por defecto (MCP_PLUGIN_DIRS) y se ejecutan in-process.
v0.1.0 — Ecosistema modular Universal MCP
Primera versión de Universal MCP: servidor MCP modular en Python con transporte dual (stdio + streamable-http/sse).
✨ Qué incluye
- MCP Core modular con auto-descubrimiento de módulos builtin y plugins externos (
MCP_PLUGIN_DIRS) — añade herramientas sin reescribir el servidor. - 6 módulos builtin / 31 tools: system, files, data, analysis, ai, automation.
- Seguridad por diseño: sandbox de archivos, SQLite read-only, math por AST-whitelist, anti-SSRF, shell opt-in, secretos enmascarados.
- CI: ruff + pytest sobre Python 3.10–3.12 (46 pruebas).
- Documentación completa: README, ARCHITECTURE.md, ADDING_MODULES.md y plugin de ejemplo.
📦 Instalación
pip install universal_mcp-0.1.0-py3-none-any.whl
# o desde el código fuente:
pip install universal_mcp-0.1.0.tar.gz🚀 Uso rápido
universal-mcp # transporte stdio (Claude Desktop)
MCP_TRANSPORT=streamable-http universal-mcp # transporte HTTP en /mcp