MCP-сервер OpenRouter

MCP-сервер (Model Context Protocol) для поиска и запроса информации о более чем 300 ИИ-моделях, доступных на OpenRouter.

Возможности

• Список моделей — Просмотр всех доступных моделей с указанием цен, лимитов контекста и возможностей

• Поиск и фильтрация — Поиск моделей по провайдеру, цене, длине контекста, функциям (инструменты, зрение и т. д.)

• Сравнение моделей — Сравнение нескольких моделей бок о бок

• Получение подробной информации — Полные метаданные для любой конкретной модели

• Кэширование ответов — 5-минутный кэш для сокращения количества вызовов API

Установка

pip install openrouter-mcp

Использование

С OpenClaw

Добавьте в конфигурацию MCP-серверов openclaw.json:

{
  "mcp": {
    "servers": {
      "openrouter-models": {
        "command": "openrouter-mcp",
        "env": {
          "OPENROUTER_API_KEY": "your-api-key"
        }
      }
    }
  }
}

Затем перезапустите шлюз. Теперь агенты могут использовать инструменты MCP для запроса моделей OpenRouter.

Примечание: OPENROUTER_API_KEY является необязательным, но рекомендуется для повышения лимитов запросов (200 запросов/мин против 20 запросов/мин). Получите свой ключ здесь: https://openrouter.ai/keys

Пример использования агентом:

# Agent can now call MCP tools like:
list_models(sort_by="context_length")
search_models(query="claude", max_input_price=5.0)
get_model(model_id="anthropic/claude-sonnet-4.6")
compare_models(model_ids="qwen/qwen3.6-plus,anthropic/claude-sonnet-4.6")

Автономно (stdio)

export OPENROUTER_API_KEY=your-key
python -m openrouter_mcp.server

Доступные инструменты

Примеры

Список моделей, отсортированный по длине контекста

{
  "name": "list_models",
  "arguments": {
    "modality": "text",
    "sort_by": "context_length"
  }
}

Поиск моделей Claude дешевле $5 за 1 млн токенов

{
  "name": "search_models",
  "arguments": {
    "query": "claude",
    "provider": "anthropic",
    "max_input_price": 5.0,
    "requires_tools": true
  }
}

Сравнение 3 моделей

{
  "name": "compare_models",
  "arguments": {
    "model_ids": "anthropic/claude-sonnet-4.6,qwen/qwen3.6-plus,openai/gpt-5.4"
  }
}

Получение подробной информации о модели

{
  "name": "get_model",
  "arguments": {
    "model_id": "anthropic/claude-sonnet-4.6"
  }
}

Справочник API

list_models(modality, sort_by)

• modality (str, по умолчанию: "text"): Фильтр по типу вывода. Варианты: text, image, audio, embeddings, all

• sort_by (str, по умолчанию: "name"): Сортировка по: name, created, price, context_length

get_model(model_id)

• model_id (str, обязательно): Слаг модели, например anthropic/claude-sonnet-4.6

search_models(query, provider, max_input_price, min_context, requires_tools, requires_vision, free_only)

• query (str): Поиск по тексту в имени/ID/описании модели

• provider (str): Фильтр по провайдеру (например, anthropic, google, openai)

• max_input_price (float): Максимальная цена за входные данные на 1 млн токенов (0 = без ограничений)

• min_context (int): Минимальный размер контекстного окна

• requires_tools (bool): Только модели, поддерживающие вызов инструментов

• requires_vision (bool): Только модели с поддержкой зрения/ввода изображений

• free_only (bool): Только бесплатные модели

compare_models(model_ids)

• model_ids (str, обязательно): Список ID моделей, разделенных запятыми

refresh_cache()

Принудительное обновление кэша моделей из API OpenRouter.

Лимиты запросов

• Без API-ключа: 20 запросов/минуту

• С API-ключом: 200 запросов/минуту

• Данные о моделях кэшируются на 5 минут

Получите свой API-ключ здесь: https://openrouter.ai/keys

Лицензия

MIT

Участие в разработке

Вклад приветствуется! Пожалуйста, откройте issue или PR на GitHub.