# @connexia/cli

> Convert existing backends into AI-native MCP-compatible interfaces

[![CI](https://github.com/aryanpatel1403/connexia-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/aryanpatel1403/connexia-cli/actions/workflows/ci.yml)
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Node.js](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen)](https://nodejs.org/)

## What It Does

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

## Quick Start

```bash
# 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](https://github.com/aryanpatel1403/connexia/blob/main/docs/01-CONNEXIA-VISION.md)
- [Developer Pipeline](https://github.com/aryanpatel1403/connexia/blob/main/docs/05-DEVELOPER-PIPELINE.md)
- [Package Catalog](https://github.com/aryanpatel1403/connexia/blob/main/docs/04-PACKAGES.md)
- [Architecture](https://github.com/aryanpatel1403/connexia/blob/main/docs/08-PACKAGE-GRAPH.md)

## Contributing

Contributions are welcome! Please read our [Contributing Guide](https://github.com/aryanpatel1403/connexia-cli/blob/main/CONTRIBUTING.md) first.

## License

[Apache-2.0](https://github.com/aryanpatel1403/connexia-cli/blob/main/LICENSE) - Connexia Contributors