CLI Referenceaerostack mcp

aerostack mcp

Convert any NPM/stdio MCP server into a Cloudflare Worker and deploy it to Aerostack. Once deployed, your MCP server is accessible over HTTP from any LLM tool.

Usage

aerostack mcp convert [flags]

Exactly one source flag is required.

Flags

FlagDescription
--package <name>NPM package name (e.g., @notionhq/notion-mcp-server)
--github <url>GitHub repository URL
--dir <path>Local directory path
-o, --outputOutput directory (default: .)
--slugServer slug for deployment (auto-derived from package name)
--deployDeploy to Aerostack after conversion

Examples

# Convert from NPM package
aerostack mcp convert --package @notionhq/notion-mcp-server
 
# Convert and deploy immediately
aerostack mcp convert --package @notionhq/notion-mcp-server --deploy --slug notion-mcp
 
# Convert from GitHub
aerostack mcp convert --github https://github.com/user/my-mcp-server
 
# Convert from local directory
aerostack mcp convert --dir ./my-mcp-server --slug my-mcp

What it does

  1. Downloads or clones the MCP server source
  2. Analyzes MCP tool definitions
  3. Detects required environment variables
  4. Generates a Cloudflare Worker wrapper
  5. Flags any incompatible Node.js APIs
  6. Optionally deploys to Aerostack

After conversion

# The generated output contains:
my-mcp-worker/
├── src/index.ts      # Worker wrapper
├── aerostack.toml    # Project config
└── package.json

Deploy manually:

cd my-mcp-worker
aerostack deploy mcp dist/index.js --slug my-notion-mcp

After deployment, your MCP server is available at a workers.dev subdomain and can be used in Aerostack workspaces. See Deploy an MCP Server for the full workflow.

aerostack testaerostack skill