MCP Filesystem Server

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

# 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

This server cannot be installed

security - not tested

license - not found

quality - not tested

A Model Context Protocol server adapted for Google Cloud Platform that enables secure file operations (reading, writing, editing, searching) with access control for specific directories.

Related MCP Servers

Google Cloud MCP Server
krzko
-
security
F
license
-
quality
A Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.
Last updated -
16
2
TypeScript
MCP Filesystem Server
safurrier
-
security
A
license
-
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
5
Python
MIT License
MCP Database Server
dwarvesf
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
Last updated -
2
TypeScript
mcp-google-sheets
xing5
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Google Drive and Google Sheets, enabling users to create, read, update, and manage spreadsheets through natural language commands.
Last updated -
134
Python
MIT License

View all related MCP servers

MCP Filesystem Server