NovAI MCP server

Q: How do I add NovAI MCP to Claude Code?

Run `claude mcp add --env NOVAI_API_KEY= novai-python -- uvx aiapi-pro` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add NovAI MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Oct 25, 2026

vvvvking/novai-python · python · MIT

Access over 120 Chinese frontier AI models through a single OpenAI-compatible endpoint via MCP tools.

Also known as vvvvking/novai-python, novai-python, aiapi-pro

stdio AI & LLM Tools

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.1.1
Last commit: Oct 25, 2026
License: MIT

What is NovAI MCP?

NovAI accesses over 120 Chinese frontier AI models through a single OpenAI-compatible endpoint via MCP tools.

Summary generated from the project's README

About NovAI MCP server

Accessing over 120 Chinese frontier AI models through a single OpenAI-compatible endpoint is what this MCP server enables for developers. By connecting to the NovAI gateway, users can interact with models like DeepSeek, Qwen, GLM, Kimi, and MiniMax using standard tools. The server works locally by configuring your MCP client, such as Claude Desktop, Cursor, or Cline, with a command to run the novai.mcp_server module and your NOVAI_API_KEY environment variable.

This setup provides specific tools including novai_chat, novai_generate_image, novai_list_models, and novai_pricing_feed. It is designed for those seeking direct provider pricing without the typical platform markups found on other aggregators. Users can start with a free tier that includes five specific models like glm-4.7-flash and cogvideox-flash, which allow up to 10 calls per day without requiring a credit card.

What you can do with it

1Querying frontier Chinese modelsAsk an AI client to perform reasoning or chat tasks using specific models like DeepSeek or Qwen.
2Generating visual contentInstruct your AI assistant to create images using models such as cogview-3-flash.
3Comparing model costsFind the most economical chat models by accessing live pricing data through the client.
4Discovering available model optionsRetrieve a full list of the 120+ supported models to see what is available for your workflow.

Written from the project's README. Every use case is checked against a quote from it.

How to install NovAI MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-pro

~/.cursor/mcp.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "novai-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.novai-python]
command = "uvx"
args = ["aiapi-pro"]

[mcp_servers.novai-python.env]
NOVAI_API_KEY = "<NOVAI_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "novai-python": {
      "command": "uvx",
      "args": [
        "aiapi-pro"
      ],
      "env": {
        "NOVAI_API_KEY": "<NOVAI_API_KEY>"
      }
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

NOVAI_API_KEYRequired
NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register

Name	Description
NOVAI_API_KEY	NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register	Required

Automated checks

Ran Nov 14, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablevvvvking/novai-python is public and reachablegithub.com/vvvvking/novai-python ↗Pass
Package names this repository as its sourceNot checked
Build provenance (Sigstore attestation)Sigstore attestation for aiapi-propypi.org/project/aiapi-pro/ ↗Pass
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-10-25github.com/vvvvking/novai-python ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNo popular package one edit away from aiapi-proPass
No critical advisory in the package or its dependencies32 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNot checked
Remote endpoint answers the MCP handshakeNot checked

README

View on GitHub

novai-python

OpenAI-compatible SDK + MCP server for 120+ Chinese frontier AI models (DeepSeek, Qwen, GLM, Kimi, Seedance, MiniMax, Hunyuan, CogVideoX, ...) via NovAI — one key, one endpoint, 0% platform fee (raw provider list price; vs OpenRouter ~5.5% markup).

Endpoint: https://aiapi-pro.com/v1 (change one base_url line from any OpenAI code)
Free: $2 signup credit, no card; plus 5 free models (no credit charge; 10 calls/day on the free tier) (glm-4.7-flash, glm-4.6v-flash, glm-4.1v-thinking-flash, cogview-3-flash, cogvideox-flash)
Live pricing: https://aiapi-pro.com/china-ai-leaderboard.json

Install

PyPI package name: aiapi-pro (import name: novai). Once published:

pip install aiapi-pro
export NOVAI_API_KEY=nvai-...   # https://aiapi-pro.com/register ($2 free)

From source (always current):

pip install git+https://github.com/vvvvking/novai-python.git
export NOVAI_API_KEY=nvai-...   # https://aiapi-pro.com/register ($2 free)

SDK quickstart

from novai import chat, list_models, generate_image, pricing

print(chat("deepseek-v4-flash", "Explain MCP in one sentence."))
print(generate_image("cogview-3-flash", "a red panda astronaut"))  # free model
print(pricing()["categories"][0]["models"][0])  # cheapest chat model, live

Any existing OpenAI code works by swapping the base URL:

from openai import OpenAI
c = OpenAI(base_url="https://aiapi-pro.com/v1", api_key="nvai-...")

MCP server

Expose the models as tools to any MCP client (Claude Desktop, Cursor, Cline, ...):

{
  "mcpServers": {
    "novai": {
      "command": "python",
      "args": ["-m", "novai.mcp_server"],
      "env": { "NOVAI_API_KEY": "nvai-..." }
    }
  }
}

Tools provided: novai_list_models, novai_chat, novai_generate_image, novai_free_models, novai_cheapest, novai_pricing_feed, novai_transparency.

Transparency

0% platform fee, 1.0x price multiplier, $5 min top-up, 60 req/min, unused-balance 7-day refund, failed video/3D jobs refunded in full. Machine-readable: https://aiapi-pro.com/transparency.json. Chinese image models apply a visible "AI-generated" corner watermark per China labeling rules (https://aiapi-pro.com/watermark-notice).

License

MIT

Read full README

NovAI MCP questions

How do I add NovAI MCP to Claude Code?

Run claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-pro in your terminal. Add --scope user to make it available in every project.

How do I add NovAI MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.1.1
Last commit: Oct 25, 2026
License: MIT
Transport: stdio
Package: aiapi-pro

vvvvking ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/vvvvking/novai-python.svg)](https://hostedmcp.org/servers/vvvvking/novai-python/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About NovAI MCP server

What you can do with it

1Querying frontier Chinese modelsAsk an AI client to perform reasoning or chat tasks using specific models like DeepSeek or Qwen.
2Generating visual contentInstruct your AI assistant to create images using models such as cogview-3-flash.
3Comparing model costsFind the most economical chat models by accessing live pricing data through the client.
4Discovering available model optionsRetrieve a full list of the 120+ supported models to see what is available for your workflow.

Written from the project's README. Every use case is checked against a quote from it.

{ "servers": { "novai-python": { "type": "stdio", "command": "uvx", "args": [ "aiapi-pro" ], "env": { "NOVAI_API_KEY": "<NOVAI_API_KEY>" } } } }

Name

Description

NOVAI_API_KEY

NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register

Required

from novai import chat, list_models, generate_image, pricing print(chat("deepseek-v4-flash", "Explain MCP in one sentence.")) print(generate_image("cogview-3-flash", "a red panda astronaut")) # free model print(pricing()["categories"][0]["models"][0]) # cheapest chat model, live

NovAI MCP questions

How do I add NovAI MCP to Claude Code?

Run claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-pro in your terminal. Add --scope user to make it available in every project.

How do I add NovAI MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

NovAI MCP server

What is NovAI MCP?

About NovAI MCP server

What you can do with it

How to install NovAI MCP

Install NovAI MCP in Claude Code

Install NovAI MCP in Cursor

Install NovAI MCP in VS Code

Install NovAI MCP in Claude Desktop

Install NovAI MCP in Codex

Install NovAI MCP in Gemini CLI

Configuration

Automated checks

README

novai-python

Install

SDK quickstart

MCP server

Transparency

License

NovAI MCP questions

NovAI MCP server

What is NovAI MCP?

About NovAI MCP server

What you can do with it

How to install NovAI MCP

Install NovAI MCP in Claude Code

Install NovAI MCP in Cursor

Install NovAI MCP in VS Code

Install NovAI MCP in Claude Desktop

Install NovAI MCP in Codex

Install NovAI MCP in Gemini CLI

Configuration

Automated checks

README

novai-python

Install

SDK quickstart

MCP server

Transparency

License

NovAI MCP questions