Metadata-Version: 2.4
Name: nova-mcp-server
Version: 1.0.0
Summary: MCP server exposing Nova ADK's design, code, and multimodal capabilities as tools for Claude Desktop, Antigravity, Cursor, Cline, Continue.
Author-email: NovaLab <hello@novalab.build>
License: Apache-2.0
Project-URL: Homepage, https://novalab.build
Project-URL: Documentation, https://novalab.build/documentation
Project-URL: Repository, https://github.com/devsuperr/nova-adk
Project-URL: Issues, https://github.com/devsuperr/nova-adk/issues
Keywords: mcp,claude,antigravity,cursor,ai,design,code-generation
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: novalab-adk>=2.2.0
Dynamic: license-file

# nova-mcp-server

[![PyPI](https://img.shields.io/pypi/v/nova-mcp-server.svg)](https://pypi.org/project/nova-mcp-server/)
[![Python](https://img.shields.io/pypi/pyversions/nova-mcp-server.svg)](https://pypi.org/project/nova-mcp-server/)

MCP server that brings [Nova ADK](https://novalab.build)'s design + code generation + multimodal tools into any MCP-compatible AI client — Claude Desktop, Google Antigravity (Gemini 3), Cursor, Cline, Continue.

## What you get

Six tools callable from your AI client:

- **nova_design** — production-ready HTML landing pages, dashboards, UI mockups (Lovable-caliber)
- **nova_tool** — functional interactive SPAs with JS + localStorage
- **nova_backend** — FastAPI or Next.js backend code (routes, schema, auth, Dockerfile)
- **nova_video** — animated MP4 scenes (GSAP + headless Chromium)
- **nova_image** — AI-generated logos, illustrations, graphics (Flux/SDXL)
- **nova_tts** — text-to-speech (6 voices, MP3)

## Install

```bash
pip install nova-mcp-server
```

You also need a [Nova API key](https://novalab.build/api-keys).

## Configure your AI client

### Claude Desktop

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "nova-adk": {
      "command": "nova-mcp-server",
      "env": {
        "NOVA_API_URL": "https://api.novalab.build",
        "NOVA_API_KEY": "nova_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop. You'll see a 🔌 tools icon in the input — Nova's 6 tools are listed.

### Google Antigravity

Settings → Agents → MCP Servers → Add:

```json
{
  "nova-adk": {
    "command": "nova-mcp-server",
    "env": {
      "NOVA_API_URL": "https://api.novalab.build",
      "NOVA_API_KEY": "nova_your_key_here"
    }
  }
}
```

### Cursor

Settings → Features → Model Context Protocol → Add MCP Server. Use same config.

### Cline / Continue / other MCP clients

Point them at the `nova-mcp-server` command with the env vars above.

## Usage in chat

```
Use nova_design to create a landing page for CodeFlow — a dev tool SaaS

Build a Kanban board via nova_tool with working drag-and-drop

Generate FastAPI backend for a Todo app via nova_backend with JWT auth
```

Your AI client will call the tool, return the result inline.

## Example output

`nova_design` returns complete HTML with Tailwind, mesh gradients, real copy, modern component patterns — the same engine that powers the Nova ADK platform itself.

## Environment variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `NOVA_API_KEY` | ✅ | — | Your API key from novalab.build |
| `NOVA_API_URL` | | `https://api.novalab.build` | Change for self-hosted Nova |
| `NOVA_MCP_LOG_LEVEL` | | `INFO` | `DEBUG` for troubleshooting |

## Troubleshooting

**"MCP server failed to start":** Check `nova-mcp-server --help` works directly (i.e. the pip install succeeded).

**"Nova API error (401)":** Invalid or expired `NOVA_API_KEY`.

**"Nova API error (429)":** Rate limited — check your [plan](https://novalab.build/plans).

## Development

Source: https://github.com/devsuperr/nova-adk/tree/main/mcp-package

```bash
git clone https://github.com/devsuperr/nova-adk
cd nova-adk/mcp-package
pip install -e .
nova-mcp-server
```

## License

Apache-2.0 © NovaLab
