MCP Filesystem Server para Google Cloud Run

Servidor MCP (Model Context Protocol) adaptado para producción en Google Cloud Platform.

Características

• 🔒 Seguridad: Control de acceso a directorios específicos

• 🔑 Autenticación: API Key opcional

• 📁 Operaciones de archivos: Leer, escribir, editar, buscar

• 🌐 HTTP/SSE Transport: Compatible con Cloud Run

• 🐳 Containerizado: Listo para desplegar

Requisitos

• Google Cloud SDK (gcloud)

• Proyecto de GCP configurado

• APIs habilitadas: Cloud Run, Cloud Build, Container Registry

Despliegue Rápido

El script:

• Habilita las APIs necesarias

• Construye la imagen Docker

• Despliega a Cloud Run

• Genera una API Key automáticamente

• Muestra la URL del servicio

Configuración Manual

Variables de Entorno

• PORT: Puerto del servidor (default: 8080)

• ALLOWED_DIRS: Directorios permitidos, separados por comas

• API_KEY: Clave de autenticación (opcional)

Ejemplo de Despliegue Manual

Uso

Health Check

Conectar Cliente MCP

Configure su cliente MCP para conectarse a:

• URL: https://your-service-url.run.app/sse

• Header: X-API-Key: your-api-key

Herramientas Disponibles

• read_file: Leer archivos

• write_file: Escribir archivos

• edit_file: Editar archivos con diffs

• create_directory: Crear directorios

• list_directory: Listar contenido

• directory_tree: Árbol de directorios

• move_file: Mover/renombrar archivos

• search_files: Buscar archivos

• get_file_info: Información de archivos

• list_allowed_directories: Ver directorios permitidos

Seguridad

• Solo accede a directorios explícitamente permitidos

• Validación de rutas para prevenir acceso no autorizado

• Autenticación por API Key

• Usuario no-root en el container

• Manejo seguro de señales con dumb-init

Monitoreo

Cloud Run proporciona métricas automáticas:

• Requests por segundo

• Latencia

• Errores

• Uso de CPU/memoria

Costos Estimados

• Cloud Run: ~$0.00002400/vCPU-segundo

• Almacenamiento: Según Container Registry

• Red: $0.12/GB egreso

Con auto-scaling, solo pagas por uso real.

Troubleshooting

Error: APIs no habilitadas

Error: Permisos insuficientes

Asegúrate de tener roles:

• Cloud Run Admin

• Cloud Build Editor

• Storage Admin

Logs

Frontend Web

Incluye una interfaz web para gestionar archivos:

Despliegue del Frontend

Características

• 📁 Explorador de archivos visual

• ✏️ Editor de texto integrado

• 🔐 Autenticación con API Key

• 💾 Crear, editar, eliminar archivos

• 📂 Gestión de directorios

Integración con Claude Desktop

Para usar con Claude Desktop, sigue las instrucciones en CLAUDE_DESKTOP_SETUP.md.

El proxy incluido (mcp-client-proxy.js) permite conectar Claude Desktop con el servidor remoto.

Arquitectura Completa

Licencia

MIT - Basado en el proyecto oficial de Anthropic