Greife über MCP tools über einen einzigen OpenAI-kompatiblen Endpoint auf über 120 chinesische Frontier-KI-Modelle zu.
Auch bekannt als vvvvking/novai-python, novai-python, aiapi-pro
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.1
- Letzter Commit
- 25. Okt. 2026
- Lizenz
- MIT
Was ist NovAI MCP?
NovAI ist ein MCP server. Greife über MCP tools über einen einzigen OpenAI-kompatiblen Endpoint auf über 120 chinesische Frontier-KI-Modelle zu.
Zusammenfassung generiert aus dem README des Projekts
Über NovAI MCP server
Dieser MCP server ermöglicht es Entwicklern, über einen einzigen OpenAI-kompatiblen Endpoint auf über 120 chinesische Frontier-KI-Modelle zuzugreifen. Durch die Verbindung mit dem NovAI-Gateway können Nutzer mit Modellen wie DeepSeek, Qwen, GLM, Kimi und MiniMax über Standard-Tools interagieren. Der Server läuft lokal, indem du deinen MCP-Client, wie Claude Desktop, Cursor oder Cline, mit einem Befehl konfigurierst, der das novai.mcp_server Modul ausführt, sowie deine NOVAI_API_KEY Umgebungsvariable setzt.
Dieses Setup bietet spezifische Tools wie novai_chat, novai_generate_image, novai_list_models und novai_pricing_feed. Es ist für alle gedacht, die direkte Provider-Preise suchen, ohne die typischen Plattform-Aufschläge, die man bei anderen Aggregatoren findet. Nutzer können mit einem Free Tier starten, das fünf spezifische Modelle wie glm-4.7-flash und cogvideox-flash enthält, die bis zu 10 Aufrufe pro Tag ohne Kreditkarte ermöglichen.
Was du damit machen kannst
- 1Abfragen von chinesischen Frontier-ModellenLass einen KI-Client Reasoning- oder Chat-Aufgaben mit spezifischen Modellen wie DeepSeek oder Qwen ausführen.
- 2Generieren von visuellem ContentAnweise deinen KI-Assistenten, Bilder mit Modellen wie cogview-3-flash zu erstellen.
- 3Modellkosten vergleichenFinde die wirtschaftlichsten Chat-Modelle, indem du über den Client auf Live-Preisdaten zugreifst.
- 4Verfügbare Modelloptionen entdeckenRufe eine vollständige Liste der über 120 unterstützten Modelle ab, um zu sehen, was für deinen Workflow verfügbar ist.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du NovAI MCP
Formate geprüft am 10. Nov. 2026NovAI MCP in Claude Code installieren
$ claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-proNovAI MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}NovAI MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"novai-python": {
"type": "stdio",
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}NovAI MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}NovAI MCP in Codex installieren
~/.codex/config.toml
[mcp_servers.novai-python] command = "uvx" args = ["aiapi-pro"] [mcp_servers.novai-python.env] NOVAI_API_KEY = "<NOVAI_API_KEY>"
NovAI MCP in Gemini CLI installieren
~/.gemini/settings.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Konfiguration
NOVAI_API_KEYErforderlichNovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register
| Name | Beschreibung | Typ |
|---|---|---|
| NOVAI_API_KEY | NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register | Erforderlich |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarvvvvking/novai-python is public and reachablegithub.com/vvvvking/novai-python ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Herkunft (Sigstore-Attestierung)Sigstore attestation for aiapi-propypi.org/project/aiapi-pro/ ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-25github.com/vvvvking/novai-python ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from aiapi-proBestanden
- Kein kritischer Hinweis im Paket oder seinen Abhängigkeiten32 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehennovai-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 onebase_urlline from any OpenAI code) - Free:
$2signup 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
NovAI MCP Fragen
Wie füge ich NovAI MCP zu Claude Code hinzu?
Führe claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-pro in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich NovAI MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.