Skip to main content
Glama
NormaHub MCP Server

NormaHub MCP Server

Official
by normahubcc

NormaHub MCP Server

npm version npm downloads Node License: MIT MCP Standard

Сервер Model Context Protocol (MCP) для API NormaHub.

Предоставляет инструменты (Tools), ресурсы (Resources) и шаблоны промптов (Prompts) для подключения моделей (DeepSeek, Claude, GPT, SeeDance Video) к Claude Desktop, Cursor, Windsurf и другим MCP-клиентам.

Поддерживает два вида транспорта:

  • Stdio — локальный запуск через npx в IDE и десктопных клиентах.

  • SSE (Server-Sent Events) — сетевой HTTP-транспорт для Docker, Kubernetes и удаленных серверов.


Архитектура сервера

┌────────────────────────────────────────────────────────┐
│                  NormaHub MCP Server                   │
└───────────────────────────┬────────────────────────────┘
                            │
     ┌──────────────────────┼──────────────────────┐
     ▼                      ▼                      ▼
  TOOLS                  RESOURCES              PROMPTS
  • normahub_prompt_model• normahub://models    • review_code
  • normahub_image_to_video • normahub://status • direct_video_scene
  • normahub_generate_video                     • cost_optimize_route
  • normahub_generate_image
  • normahub_list_models

Related MCP server: ComfyUI MCP Server

Возможности

1. Tools (Инструменты)

Инструмент

Описание

Основные параметры

normahub_prompt_model

Вызов LLM (диалоги и история сообщений)

model, prompt, messages, system, temperature

normahub_image_to_video

Генерация видео из статичного изображения (I2V) через SeeDance

image_url (URL или data URI), prompt, model

normahub_generate_video

Генерация видео из текста (T2V) через SeeDance / Grok Video

prompt, model, duration, aspect_ratio

normahub_generate_image

Генерация изображений

prompt, model

normahub_list_models

Список подключенных моделей и тарифов

—

2. Resources (Ресурсы)

  • normahub://models — структурированный каталог поддерживаемых моделей, контекстных окон, capabilities и тарифов (JSON и Markdown).

  • normahub://status — статус шлюза, latency ping и список активных маршрутов.

3. Prompts (Шаблоны)

  • review_code — шаблон для код-ревью (архитектура, безопасность, производительность, diff).

  • direct_video_scene — шаблон для формирования сценария генерации видео (оптика, свет, физика камеры) под SeeDance.

  • cost_optimize_route — подбор наиболее экономичной модели под задачу.


Быстрый старт

Claude Desktop (Stdio)

Добавьте сервер в конфигурационный файл Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "normahub": {
      "command": "npx",
      "args": ["-y", "@normahub/mcp-server"],
      "env": {
        "NORMAHUB_API_KEY": "nr_hub_..."
      }
    }
  }
}

Cursor IDE

В настройках Settings > Features > MCP > Add New MCP Server:

  1. Name: normahub

  2. Type: command

  3. Command: npx -y @normahub/mcp-server

  4. Environment Variables: NORMAHUB_API_KEY=nr_hub_...


Готовые шаблоны конфигураций

Готовые JSON-файлы конфигурации для Claude Desktop, Cursor (.cursor/mcp.json), Zed и Continue.dev доступны в директории examples/.


Сетевой запуск (SSE Transport)

Для совместного использования командой или работы в контейнерах:

Локальный запуск SSE:

git clone https://github.com/normahubcc/mcp-server-normahub.git
cd mcp-server-normahub
npm install
npm run build

export NORMAHUB_API_KEY="nr_hub_..."
npm run start:sse

Сервер будет доступен на порту 3001:

  • SSE поток: http://localhost:3001/sse

  • POST сообщений: http://localhost:3001/messages

  • Health check: http://localhost:3001/health

Запуск в Docker:

docker build -t normahub-mcp-server .
docker run -d \
  -p 3001:3001 \
  -e NORMAHUB_API_KEY="nr_hub_..." \
  --name normahub-mcp \
  normahub-mcp-server

Отладка через MCP Inspector

npm run inspect

Команда запустит локальный веб-интерфейс MCP Inspector для интерактивного тестирования вызовов инструментов и чтения ресурсов.


Лицензия

MIT License. См. LICENSE.

Available Tools

7 tools
normahub_generate_imageC

Generate images using GPT Image or Grok Imagine Image via NormaHub API.

Inputs: prompt (required), model.

normahub_generate_videoB

Generate AI videos using SeeDance 2.5 / 2.0 and xAI Grok Imagine Video via NormaHub API. Automatically polls until video render completes.

Inputs: prompt (required), model.

normahub_get_balanceA

Check your current NormaHub account balance in Russian Rubles (RUB), active tier, and remaining tokens.

Inputs: no named parameters.

normahub_image_to_videoB

Animate an input image into a video (Image-to-Video) using SeeDance 2.5 / 2.0 via NormaHub API. Accepts image URL and animation prompt. Automatically polls until video render completes.

Inputs: prompt (required), image_url (required), model.

normahub_list_modelsA

List currently available active AI models and their pricing on NormaHub API.

Inputs: no named parameters.

normahub_prompt_modelC

Send a prompt to LLM models via NormaHub API (Claude, GPT, DeepSeek, Qwen).

Inputs: model, prompt, system, messages, +2 more.

normahub_transcribe_audioA

Transcribe audio recordings, voice notes, and video soundtracks to text using OpenAI Whisper via NormaHub API without VPN. Accepts local file path or public HTTP URL.

Inputs: url, model, prompt, language, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation4/5

    Each tool maps to a distinct capability: text prompting, image generation, text-to-video, image-to-video, transcription, model listing, and billing. The only mild overlap is between normahub_generate_video and normahub_image_to_video, but the descriptions clearly differentiate them by input (image required vs. prompt-only).

    Naming Consistency5/5

    Every tool uses the same normahub_ prefix followed by a clear verb_noun or verb_object pattern in snake_case. No mixing of conventions or vague standalone verbs.

    Tool Count5/5

    Seven tools is a well-scoped surface for a multi-modal AI API gateway. Each tool corresponds to a real, non-redundant operation and no filler tools are present.

    Completeness4/5

    The surface covers the core modalities (text, image, video, image-to-video, audio transcription) plus account inspection via balance and model listing. Minor gaps exist: no text-to-speech/audio generation, no image editing/upscale, and no usage-history or job-status tool, though built-in polling mitigates the latter.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers