@migrateforce/cli

Unified CLI for converting OpenAPI REST APIs into production-ready MCP server code.

Quick Start

The npm-safe direct invocation is:

npx @migrateforce/cli convert \
  --spec openapi.yaml \
  --base-url https://api.example.com \
  --output ./my-mcp-server

If you want the branded command name (@migrateforce) without a global install:

npx --yes --package @migrateforce/cli @migrateforce convert \
  --spec openapi.yaml \
  --base-url https://api.example.com \
  --output ./my-mcp-server

Convert Command

migrateforce convert --spec <path> [options]

Options:

• --base-url <url> Target REST base URL. If omitted, the CLI uses the first absolute http(s) URL in servers[].
• --output <dir> Output directory (default: ./mcp-server)
• --include <pattern> Include endpoints matching pattern ("GET /users*").
• --exclude <pattern> Exclude endpoints matching pattern.
• --dry-run Show endpoint-to-tool mapping only.
• --json Print generated artifacts as JSON to stdout.
• --cloud Use cloud enrichment (lint, skill matching, readiness score).
• --save-project Save project to dashboard (requires --cloud).
• --force Overwrite non-empty output directory.

Cloud Mode

Set API key:

export MIGRATEFORCE_API_KEY=mf_live_...

Run cloud conversion:

npx @migrateforce/cli convert \
  --spec openapi.yaml \
  --base-url https://api.example.com \
  --output ./my-mcp-server \
  --cloud \
  --save-project