Accede a más de 120 modelos de IA de vanguardia de China a través de un único endpoint compatible con OpenAI mediante herramientas MCP.
También conocido como vvvvking/novai-python, novai-python, aiapi-pro
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.1
- Último commit
- 25 oct 2026
- Licencia
- MIT
¿Qué es NovAI MCP?
NovAI es un MCP server. Accede a más de 120 modelos de IA de vanguardia de China a través de un único endpoint compatible con OpenAI mediante herramientas MCP.
Resumen generado a partir del README del proyecto
Acerca del MCP server de NovAI
Este MCP server permite a los desarrolladores acceder a más de 120 modelos de IA de vanguardia de China mediante un único endpoint compatible con OpenAI. Al conectarse a la pasarela de NovAI, los usuarios pueden interactuar con modelos como DeepSeek, Qwen, GLM, Kimi y MiniMax utilizando herramientas estándar. El servidor funciona localmente configurando tu cliente MCP, como Claude Desktop, Cursor o Cline, con un comando para ejecutar el módulo novai.mcp_server y tu variable de entorno NOVAI_API_KEY.
Esta configuración proporciona herramientas específicas que incluyen novai_chat, novai_generate_image, novai_list_models y novai_pricing_feed. Está diseñado para quienes buscan los precios directos del proveedor sin los sobrecostes típicos de otras plataformas agregadoras. Los usuarios pueden comenzar con un nivel gratuito que incluye cinco modelos específicos como glm-4.7-flash y cogvideox-flash, que permiten hasta 10 llamadas al día sin necesidad de una tarjeta de crédito.
Qué puedes hacer con él
- 1Consultar modelos chinos de vanguardiaPide a un cliente de IA que realice tareas de razonamiento o chat utilizando modelos específicos como DeepSeek o Qwen.
- 2Generar contenido visualIndica a tu asistente de IA que cree imágenes utilizando modelos como cogview-3-flash.
- 3Comparar costes de modelosEncuentra los modelos de chat más económicos accediendo a datos de precios en tiempo real a través del cliente.
- 4Descubrir opciones de modelos disponiblesObtén una lista completa de los más de 120 modelos compatibles para ver qué opciones tienes disponibles para tu flujo de trabajo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar NovAI MCP
Formatos verificados el 10 nov 2026Instalar NovAI MCP en Claude Code
$ claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-proInstalar NovAI MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Instalar NovAI MCP en VS Code
.vscode/mcp.json
{
"servers": {
"novai-python": {
"type": "stdio",
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Instalar NovAI MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Instalar NovAI MCP en Codex
~/.codex/config.toml
[mcp_servers.novai-python] command = "uvx" args = ["aiapi-pro"] [mcp_servers.novai-python.env] NOVAI_API_KEY = "<NOVAI_API_KEY>"
Instalar NovAI MCP en Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Configuración
NOVAI_API_KEYObligatorioNovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register
| Nombre | Descripción | Tipo |
|---|---|---|
| NOVAI_API_KEY | NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register | Obligatorio |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblevvvvking/novai-python is public and reachablegithub.com/vvvvking/novai-python ↗Aprobado
- El paquete cita este repositorio como fuenteNo verificado
- Procedencia de la compilación (atestación Sigstore)Sigstore attestation for aiapi-propypi.org/project/aiapi-pro/ ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-25github.com/vvvvking/novai-python ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from aiapi-proAprobado
- Sin avisos críticos en el paquete ni en sus dependencias32 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake MCPNo verificado
README
Ver en GitHubnovai-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
Preguntas sobre NovAI MCP
¿Cómo agrego NovAI MCP a Claude Code?
Ejecuta claude mcp add --env NOVAI_API_KEY=<NOVAI_API_KEY> novai-python -- uvx aiapi-pro en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego NovAI MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.