Skip to main content
Glama
NUbem000

MCP Filesystem Server

by NUbem000

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

Related MCP Connectors

  • An MCP server that provides read access to your cloud storage providers, bank accounts and more.

  • The Google Compute Engine MCP server is a fully-managed Model Context Protocol server that provides tools to manage Google Compute Engine resources through AI agents. It enables capabilities including instance management (creating, starting, stopping, resetting, listing), disk management, handling instance templates and group managers, viewing machine and accelerator types, managing images, and accessing reservation and commitment information. The server operates as a zero-deployment, enterprise-grade endpoint at https://compute.googleapis.com/mcp with built-in IAM-based security.

  • The BigQuery remote MCP server is a fully managed service that uses the Model Context Protocol to connect AI applications and LLMs to BigQuery data sources. It provides secure, standardized tools for AI agents to list datasets and tables, retrieve schemas, generate and execute SQL queries through natural language, and analyze data—enabling direct access to enterprise analytics data without requiring manual SQL coding.

  • The Google GKE MCP server is a managed Model Context Protocol server that provides AI applications with tools to manage Google Kubernetes Engine (GKE) clusters and Kubernetes resources. It exposes a structured, discoverable interface that allows AI agents to interact with GKE and Kubernetes APIs, enabling them to inspect cluster configurations, retrieve Kubernetes resource YAMLs, monitor operations like cluster upgrades, diagnose issues, and optimize costs—all without needing to parse text output or use complex kubectl commands.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    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.
    40
    131
    81
    Apache 2.0
  • A
    license
    A
    quality
    F
    maintenance
    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.
    21
    67
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    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.
    996
    MIT