File Gateway

A file management system providing S3 file operations through a REST API and MCP server for AI agents.

Overview

File Gateway provides:

File API - FastAPI REST service for S3 file operations (list, upload, download, delete)
MCP Server - Model Context Protocol server for agent file access
VersityGW - S3-compatible gateway for object storage backend
Persistent Storage - Kubernetes PVC-backed storage

File Size Limitations

The Filesystem MCP Server is designed for small files that can be directly loaded into agent context. For this reason it enforces a 1MB file size limit for uploads.

For larger files or datasets, consider using RAG (Retrieval-Augmented Generation) or vectorization patterns.

Install


ark install marketplace/services/file-gateway

Or with DevSpace:


cd services/file-gateway
devspace deploy

Or with Helm:


helm install file-gateway ./chart -n default

Access via:

Port forward: kubectl port-forward svc/file-gateway-file-api 8080:8080
Ark Dashboard → Files page

Services

File API

FastAPI REST service for S3 file operations via VersityGW. Provides endpoints for listing, uploading, downloading, and deleting files from S3-compatible storage.

Port: 8080

Filesystem MCP Server

Model Context Protocol server that provides file system access tools for AI agents. Agents can interact with the file storage through MCP tools.

For detailed documentation on available tools and usage, see the Filesystem MCP Server documentation.

Port: 8000

VersityGW

S3-compatible gateway for object storage, providing the underlying storage backend.

Port: 7070

Configuration

Parameter	Description	Default
`fileApi.image.repository`	File API container image	`ghcr.io/mckinsey/agents-at-scale-marketplace/file-api`
`fileApi.service.port`	File API service port	`80`
`filesystemMcp.enabled`	Enable MCP server	`true`
`filesystemMcp.config.bucketName`	S3 bucket name	`aas-files`
`versitygw.enabled`	Enable VersityGW	`true`
`versitygw.service.port`	VersityGW service port	`80`
`storage.enabled`	Enable persistent storage	`true`
`storage.size`	Storage size	`1Gi`
`httpRoute.enabled`	Enable Gateway API HTTPRoute	`true`

Usage with Agents

Agents can access files through the Filesystem MCP Server. The MCP server is automatically registered with Ark and provides file operation tools to connected agents.

See the Filesystem MCP Server documentation for details on:

Available filesystem tools
Creating agents with filesystem access
Configuring workspaces
Example queries and operations

Use the ark-dashboard to browse and manage files.

Uninstall

Using Ark CLI:


ark uninstall marketplace/services/file-gateway

Using Helm:


helm uninstall file-gateway -n default

Using DevSpace:


cd services/file-gateway
devspace purge