nova-mcp-server
MCP server that brings Nova ADK'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
pip install nova-mcp-server
You also need a Nova API key.
Configure your AI client
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.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:
{
"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.
Development
Source: https://github.com/devsuperr/nova-adk/tree/main/mcp-package
git clone https://github.com/devsuperr/nova-adk
cd nova-adk/mcp-package
pip install -e .
nova-mcp-server
License
Apache-2.0 © NovaLab
Metadata
Release files for nova-mcp-server 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nova_mcp_server-1.0.0.tar.gz | 9.1 kB | Without provenance | Details for nova_mcp_server-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nova_mcp_server-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for nova_mcp_server-1.0.0-py3-none-any.whl |
Total release size: 17.9 kB
Release files / nova_mcp_server-1.0.0.tar.gz
| Download URL | nova_mcp_server-1.0.0.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09f4ae23c64631cbc339d711c83f7c5848de7cd930ebf2be3cf53583fe78c335
|
|
BLAKE2b-256 checksum How to use checksums |
d95c3243578bd5880244b2bbb7fe03b583d6d3f1e0f51fbb5f2c039b444d6540
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / nova_mcp_server-1.0.0-py3-none-any.whl
| Download URL | nova_mcp_server-1.0.0-py3-none-any.whl |
|---|---|
| Size | 8.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d39927394e2a5d406a608b17eae4cab8a5fdf1b1ec9a77b278ae1cbff3a48e41
|
|
BLAKE2b-256 checksum How to use checksums |
dea89834436be2ab32f2306df00f0344f603620d06ce62cc6d6f444f93cda19c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for nova-mcp-server 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.