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

Related MCP server: MCP Filesystem Server

Requisitos

• Google Cloud SDK (gcloud)

• Proyecto de GCP configurado

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

Despliegue Rápido

# 1. Configurar tu proyecto GCP
gcloud config set project YOUR_PROJECT_ID

# 2. Ejecutar script de despliegue
./deploy.sh

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

# Build
gcloud builds submit --tag gcr.io/PROJECT_ID/mcp-filesystem-server

# Deploy
gcloud run deploy mcp-filesystem-server \
  --image gcr.io/PROJECT_ID/mcp-filesystem-server \
  --region us-central1 \
  --set-env-vars "ALLOWED_DIRS=/tmp,API_KEY=tu-clave-segura"

Uso

Health Check

curl https://your-service-url.run.app/health

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

gcloud services enable cloudbuild.googleapis.com cloudrun.googleapis.com

Error: Permisos insuficientes

Asegúrate de tener roles:

• Cloud Run Admin

• Cloud Build Editor

• Storage Admin

Logs

gcloud run services logs read mcp-filesystem-server --region us-central1

Frontend Web

Incluye una interfaz web para gestionar archivos:

Despliegue del Frontend

cd frontend
./deploy.sh

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

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  Claude Desktop │────▶│   Proxy Local    │────▶│  MCP Server     │
│    (StdIO)      │     │  (HTTP/SSE)      │     │  (Cloud Run)    │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                                                           │
┌─────────────────┐                                       │
│   Frontend Web  │───────────────────────────────────────┘
│   (Browser)     │
└─────────────────┘

Licencia

MIT - Basado en el proyecto oficial de Anthropic