Skip to main content
This guide covers local mode for self-hosted deployments and development. For the standard cloud experience, see the Quickstart.
This guide shows how to use Airstore locally with your own MCP servers. You’ll configure tools, mount them as a filesystem, and use them with Claude Code.

​
Prerequisites

  • Airstore CLI installed
  • Node.js (for npx-based MCP servers)
  • FUSE dependencies (installed by the install script)

​
Step 1: Configure your tools

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"]

​
Step 2: Mount the filesystem

airstore mount ~/airstore --config config.local.yaml
Your tools are now available: 
ls ~/airstore/tools/
# filesystem  memory  wikipedia

​
Step 3: Use the tools

Each tool works like a regular CLI command: 
# Search Wikipedia
~/airstore/tools/wikipedia search "artificial intelligence"

# List files
~/airstore/tools/filesystem list_directory /tmp

# Store information in memory
~/airstore/tools/memory create_entities '[{"name": "project", "type": "note"}]'

​
Step 4: Run Claude Code

cd ~/airstore
claude "Use the wikipedia tool to research Alan Turing and summarize his contributions"
Claude Code can invoke the tools directly and combine results.

​
Why local mode?

Use caseDescription
DevelopmentTest MCP servers before deploying to cloud
Self-hostedRun everything on your own infrastructure
Custom toolsUse internal MCP servers not available publicly
OfflineWork without internet connectivity

​
Chaining tools

Because tools output JSON, you can chain them with standard bash: 
# Search Wikipedia and filter results
~/airstore/tools/wikipedia search "physics" | jq '.results[:3]'

# Store search results in memory
RESULTS=$(~/airstore/tools/wikipedia search "Alan Turing")
~/airstore/tools/memory create_entities "[{\"name\": \"turing-research\", \"type\": \"note\", \"observations\": [\"$RESULTS\"]}]"

​
Adding more tools

Add tools to your config and remount: 
tools:
  mcp:
    # ... existing tools ...
    
    github:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: "${GITHUB_TOKEN}"

# Unmount (Ctrl+C) and remount
export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
airstore mount ~/airstore --config config.local.yaml
Now you have GitHub access too: 
~/airstore/tools/github list_repositories --owner=acme

​
Next steps

Tools concept

Learn more about how tools work.

Config reference

Full configuration options.