Routara LLM Gateway

БесплатноНе проверен

OpenAI-compatible LLM, image and video APIs via Routara (api.routara.ai).

автор: io.github.36412749-collab

GitHub Embed

Описание

OpenAI-compatible LLM, image and video APIs via Routara (api.routara.ai).

README

npm version MCP Registry Glama MCP License: MIT

Official Model Context Protocol server for Routara — call 787+ LLMs, image, and video models through api.routara.ai from Cursor, Claude Desktop, Windsurf, VS Code, and other MCP clients.

Website: https://routara.ai
API: https://api.routara.ai/v1
Get API key: https://routara.ai/#auth ($1 promo credit on signup)

Install

npx -y routara-mcp

Or add globally: npm install -g routara-mcp

Tools

Tool	Description
`routara_list_models`	List models in the Routara catalog
`routara_chat`	Chat completion (OpenAI-compatible)
`routara_generate_image`	Image generation (cash wallet balance required)
`routara_generate_video`	Submit async video job (cash balance required)
`routara_get_video_status`	Poll video task status

Quick start

Create an API key at routara.ai → Auth (sk-or-v1-...).
Add to your MCP client:

Cursor

Settings → MCP → Add server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

Environment

Variable	Required	Default
`ROUTARA_API_KEY`	Yes	—
`ROUTARA_API_BASE`	No	`https://api.routara.ai/v1`

Listed on

npm · [email protected]
Official MCP Registry · io.github.36412749-collab/routara-mcp
Glama · claimed listing
mcp.so
Smithery
PulseMCP

Health check (Glama / CI)

The server starts without ROUTARA_API_KEY so registries can run MCP handshake (initialize + tools/list). API key is required only when invoking tools.

npm ci && npm run build && npm test
# Optional live probe (needs real key):
ROUTARA_API_KEY=sk-or-v1-... npm run test:live

After pushing to GitHub, re-run Claim ownership on Glama once to refresh the listing index.

Troubleshooting

Symptom	Fix
`ROUTARA_API_KEY is required` on tool call	Set env in MCP client config; get key at routara.ai/#auth
`401 invalid_api_key`	Regenerate key in dashboard; ensure `sk-or-v1-` prefix
`402` / insufficient balance	Top up cash wallet at routara.ai
Image/video fails, chat works	Media requires cash balance; promo credits are chat-only on economy models
Server won't start in inspector	Use `npx -y routara-mcp` with Node ≥18; run `npm run build` if developing from source

Development

npm install
npm run build
ROUTARA_API_KEY=sk-or-v1-... npm run test:live
npm test

Billing notes

One API key works for text, image, and video — switch model and tool, not the key.
Image/video require cash wallet balance (promo credits cannot be used for media).
Chat uses standard per-token billing with Smart Route™ failover across upstream pools.

JSON Translate GitHub Action: https://github.com/36412749-collab/json-translate-action
Docs: https://routara.ai/docs

License

MIT © Routara

from github.com/36412749-collab/routara-mcp

Установить Routara LLM Gateway в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install routara-llm-gateway

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add routara-llm-gateway -- npx -y routara-mcp

FAQ