English Français العربية

Hubris

السجل الرسمي الذكاء الاصطناعي والوكلاء

OpenAI-compatible LLM gateway for Russia: 500+ models, ruble pricing, balance, chat.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http hubris 'https://api.hubris.pw/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hubris": {
            "type": "http",
            "url": "https://api.hubris.pw/mcp"
        }
    }
}
NPM package hubris-mcp
Claude Code 
claude mcp add hubris -e 'HUBRIS_API_KEY=<your hubris_api_key>' -- npx -y hubris-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hubris": {
            "command": "npx",
            "args": [
                "-y",
                "hubris-mcp@0.1.1"
            ],
            "env": {
                "HUBRIS_API_KEY": "<your hubris_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • HUBRIS_API_KEY إلزامي سري API key from https://hubris.pw/keys

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Hubris MCP
  2. Tools
  3. Resources
  4. Prompts
  5. Run locally (stdio)
  6. Connect
  7. Security
  8. About Hubris

Hubris MCP

Model Context Protocol server for Hubris — an OpenAI-compatible LLM gateway with billing in rubles. Connect Claude Desktop, Claude Code, Cline, Cursor or any other MCP client to a single hosted server and get access to the model catalog, account balance and spending, and every kind of model in it: text, embeddings, rerankers, decision models, images, speech, transcription, video and YouTube transcripts.

There are two ways in: connect your client straight to the hosted endpoint, or run the stdio server in this repository, which declares the same tools locally and forwards calls to that endpoint. The second is what you want for clients that speak stdio only, and for sandboxes that build from a Dockerfile.

Listing the tools needs no credential; only calling one does. With HUBRIS_API_KEY set, the stdio server takes the tool list live from the hosted endpoint, so it never lags behind new tools; without a key it serves the list bundled with the package.

Tools

ToolDescription
models_listFull catalog of active models, cursor-paginated.
models_searchFilter by the tool that runs the model (tool), capability, price, context length.
models_get_pricingPricing for a specific model, in rubles; voices for speech models, durations and resolutions for video models.
balance_getCurrent account balance.
usage_getSpending over a period: requests, tokens, rubles.
chat_completeLLM chat request — same as POST /v1/chat/completions.
embeddings_createEmbedding vectors — POST /v1/embeddings.
rerankOrder documents by relevance to a query — POST /v1/rerank.
decisions_askYes/no, choice and scale answers with probabilities — POST /v1/decisions.
image_generateDraw an image, returned as image content — POST /v1/images/generations.
speech_createText to speech, returned as audio content — POST /v1/audio/speech.
transcription_createSpeech to text from base64 audio — POST /v1/audio/transcriptions.
video_createStart a video generation — POST /v1/videos.
video_getStatus of a video task; download links once it is ready — GET /v1/videos/{id}.
youtube_transcribeTranscript or summary of a YouTube video — POST /v1/video/transcriptions.

Resources

URIContent
hubris://catalog/modelsFull model catalog as a single JSON document.
hubris://docs/quickstartQuickstart page.
hubris://videos/{id}/contentA finished video, linked from video_get (hosted endpoint only).

Prompts

  • compare-models {task} — ready-made prompt for comparing models for a given task.

Run locally (stdio)

npm install && npm run build
HUBRIS_API_KEY=sk-gw-... node dist/index.js

Or with Docker:

docker build -t hubris-mcp .
docker run -i --rm -e HUBRIS_API_KEY=sk-gw-... hubris-mcp

In an MCP client config:

{
  "mcpServers": {
    "hubris": {
      "command": "node",
      "args": ["/path/to/hubris-mcp/dist/index.js"],
      "env": { "HUBRIS_API_KEY": "sk-gw-..." }
    }
  }
}

HUBRIS_MCP_URL overrides the endpoint if you need to point it elsewhere.

Connect

Claude Code
claude mcp add --transport http hubris https://api.hubris.pw/mcp \
  --header "Authorization: Bearer sk-gw-..."
Claude Desktop

Claude Desktop only speaks stdio, so remote HTTP servers go through the mcp-remote shim. Add to claude_desktop_config.json:

{
  "mcpServers": {
    "hubris": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.hubris.pw/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer sk-gw-..."
      }
    }
  }
}
Cline / Cursor / other clients

Any MCP client with Streamable HTTP transport support:

FieldValue
TransportStreamable HTTP
URLhttps://api.hubris.pw/mcp
Auth headerAuthorization: Bearer sk-gw-...

Full connection guide (with client-specific caveats): hubris.pw/docs/integrations/mcp.

Security

The Bearer key grants access to your account balance. We recommend creating a dedicated key for MCP at hubris.pw/keys so it can be revoked independently of other integrations.

About Hubris

Hubris is an OpenAI-compatible LLM gateway for the Russian market — one API key, one ruble-denominated balance, 400+ models. hubris.pw

الأسئلة الشائعة

ما هو Hubris؟

OpenAI-compatible LLM gateway for Russia: 500+ models, ruble pricing, balance, chat.

كيف أثبّت Hubris؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hubris 'https://api.hubris.pw/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Hubris إلى مفتاح API؟

نعم. يتطلب HUBRIS_API_KEY، وتضبطها في إعداداته.

هل Hubris مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Hubris؟

ينشره Aimagine-life. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.