@connexia/cli

Convert existing backends into AI-native MCP-compatible interfaces

What It Does

Connexia CLI analyzes your existing Express, Fastify, NestJS, Hono, or Koa backend and generates a complete Model Context Protocol (MCP) server. This makes your backend accessible to AI clients like Claude Desktop, Cursor, VS Code MCP, and ChatGPT.

Quick Start

# Install globally
npm install -g @connexia/cli

# Initialize a project
connexia init

# Scan your backend
connexia scan ./my-backend

# Generate MCP server
connexia generate

# Verify it works
connexia verify

# Start the server
connexia serve

Commands

Command	Description
connexia init	Initialize a new Connexia project
connexia scan [path]	Scan a backend to discover capabilities
connexia generate	Generate an MCP server from scan results
connexia verify	Verify the generated server compiles and starts
connexia serve	Start the MCP server
connexia doctor	Check system health and dependencies
connexia update	Update platform configuration
connexia sync	Sync project with remote configuration
connexia help [command]	Show help information

Global Options

-v, --verbose      Enable verbose output
-s, --silent       Suppress all output except errors
--dry-run          Preview changes without applying them
-c, --config       Path to configuration file

Requirements

• Node.js >= 22.0.0
• npm, pnpm, or yarn

MCP Protocol Support

• JSON-RPC 2.0 compliant
• initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, ping
• Batch request processing
• Notification handling

AI Client Compatibility

• Claude Desktop
• Cursor
• VS Code MCP
• ChatGPT / OpenAI

Security

• HMAC-SHA256 authentication with timing-safe comparison
• JWT token validation with expiration checks
• Config merge protection against prototype pollution
• Scanner path validation

Documentation

• Connexia Vision
• Developer Pipeline
• Package Catalog
• Architecture

Contributing

Contributions are welcome! Please read our Contributing Guide first.

License

Apache-2.0 - Connexia Contributors