Skip to main content
Perfect for local development with persistent sessions across restarts. File storage persists sessions to a JSON file on disk. Ideal for:
  • Local development
  • Single-instance deployments
  • Testing with persistent state
  • Environments without Redis

Configuration

Features

  • Persistent across application restarts
  • No external dependencies
  • Human-readable JSON format
  • Automatic directory creation

Usage

When MCP_TS_STORAGE_FILE is present in your environment, the global sessions proxy automatically uses the File System backend.

Option 2: Manual Instantiation

If you want to manage the File System backend yourself:

File Format

Troubleshooting

File Storage Not Persisting