Access over 120 Chinese frontier AI models through a single OpenAI-compatible endpoint via MCP tools.
Также известен как vvvvking/novai-python, novai-python, aiapi-pro
- Звёзды
- 0
- Инструменты
- —
- Загрузки, 30 дней
- 146
- Последняя версия
- 0.1.1
- Последний коммит
- 25 окт. 2026 г.
- Лицензия
- MIT
Что такое NovAI MCP?
Access over 120 Chinese frontier AI models through a single OpenAI-compatible endpoint via MCP tools.
Сводка сгенерирована из README проекта
О 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.
Что вы можете с ним делать
- 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.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить NovAI MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка NovAI MCP в Claude Code
$ claude mcp add --env 'NOVAI_API_KEY=<NOVAI_API_KEY>' novai-python -- uvx aiapi-proУстановка NovAI MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Установка NovAI MCP в VS Code
.vscode/mcp.json
{
"servers": {
"novai-python": {
"type": "stdio",
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Установка NovAI MCP в VS Code CLI
$ code --add-mcp '{"name":"novai-python","type":"stdio","command":"uvx","args":["aiapi-pro"],"env":{"NOVAI_API_KEY":"<NOVAI_API_KEY>"}}'Установка NovAI MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Установка NovAI MCP в Codex
$ codex mcp add novai-python --env 'NOVAI_API_KEY=<NOVAI_API_KEY>' -- uvx aiapi-proУстановка NovAI MCP в Codex config.toml
~/.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 в Gemini CLI
$ gemini mcp add -s user -e 'NOVAI_API_KEY=<NOVAI_API_KEY>' novai-python uvx -- aiapi-proУстановка NovAI MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"novai-python": {
"command": "uvx",
"args": [
"aiapi-pro"
],
"env": {
"NOVAI_API_KEY": "<NOVAI_API_KEY>"
}
}
}
}Конфигурация
NOVAI_API_KEYОбязательноNovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register
| Название | Описание | Тип |
|---|---|---|
| NOVAI_API_KEY | NovAI API key. Get $2 free credit (no card) at https://aiapi-pro.com/register | Обязательно |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийvvvvking/novai-python is public and reachablegithub.com/vvvvking/novai-python ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Sigstore attestation for aiapi-propypi.org/project/aiapi-pro/ ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-25github.com/vvvvking/novai-python ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from aiapi-proПройдено
- Нет критических предупреждений в пакете или его зависимостях32 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на 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
Вопросы о NovAI MCP
Как добавить NovAI MCP в Claude Code?
Выполните claude mcp add --env 'NOVAI_API_KEY=<NOVAI_API_KEY>' novai-python -- uvx aiapi-pro в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить NovAI MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.