Skip to main content
Mount Airstore locally for development and personal use.

​
Quick start

airstore mount ~/airstore --config config.local.yaml
Your tools are now available at ~/airstore/tools/.

​
Prerequisites

​
1. Install FUSE

# Install FUSE-T
brew install fuse-t

​
2. Install Node.js (for npx)

Most MCP servers are distributed via npm and run with npx: 
# macOS
brew install node

# Ubuntu/Debian
sudo apt install nodejs npm

​
Configuration

Create a config.local.yaml file: 
mode: local

gateway:
  grpc:
    port: 1993
  http:
    host: 127.0.0.1
    port: 1994

tools:
  mcp:
    filesystem:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp", "/Users"]

    memory:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-memory"]

    wikipedia:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-wikipedia"]

​
Mount

airstore mount ~/airstore --config config.local.yaml
You should see: 
  airstore mounted

  Mount    ~/airstore
  Gateway  127.0.0.1:1993
  Mode     local

  Available paths:
    /tools/*        Tool binaries

  Press Ctrl+C to unmount

​
Using tools

# List available tools
ls ~/airstore/tools/

# Run a tool
~/airstore/tools/wikipedia search "artificial intelligence"

# Get help
~/airstore/tools/filesystem --help

​
Mount options

# Mount with verbose logging
airstore mount ~/airstore --config config.local.yaml --verbose
OptionDescription
--config, -cPath to config file (required for local mode)
--verbose, -vEnable verbose logging

​
Unmounting

Press Ctrl+C in the terminal running the mount command, or: 
# macOS
diskutil unmount ~/airstore

# Linux
fusermount -u ~/airstore

​
Adding environment variables

For tools that need API keys, set environment variables before mounting: 
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
airstore mount ~/airstore --config config.local.yaml
Or reference them in your config: 
tools:
  mcp:
    github:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: "${GITHUB_TOKEN}"