Models MCP

Ищите, сравнивайте и изучайте ИИ-модели по цене, размеру контекстного окна и возможностям. MCP-сервер поверх каталога models.dev (models.dev/api.json), так что ваш агент всегда имеет актуальные данные о моделях без ручного ведения списка.

Сам models.dev не поставляет MCP-сервер, только JSON API и TypeScript SDK для чтения. Этот репозиторий закрывает этот пробел.

Из одного и того же кода инструмента работает двумя способами:

• stdio (src/index.ts) для локальных MCP-клиентов

• Cloudflare Worker (src/worker.ts) как удалённая конечная точка Streamable HTTP на /mcp

Инструменты

Install

npm install
npm run build

Запуск автономно через stdio (для тестирования)

npm start

Он говорит на MCP через stdio, поэтому напрямую вы многого не увидите; используйте MCP Inspector, чтобы пощупать его:

npx @modelcontextprotocol/inspector node dist/index.js

Размещение на Cloudflare Workers

Точка входа Worker (src/worker.ts) предоставляет те же инструменты через Streamable HTTP на /mcp, со следующими возможностями:

• Кэширование каталога в Workers Cache API (caches.default) с TTL 1 час, общим для запросов и изолятов.

• Ограничение запросов на IP через привязку rate limiting Workers: 60 запросов/мин на IP, которое применяется для каждой локации Cloudflare. Избыточные запросы получают 429 с Retry-After: 60.

# local dev at http://localhost:8787/mcp
npm run dev:worker

# deploy
npm run deploy

После развёртывания ваша конечная точка: https://models-mcp.<your-subdomain>.workers.dev/mcp.

Направьте MCP-клиенты на неё:

Claude Code:

claude mcp add --transport http models-mcp https://models-mcp.<your-subdomain>.workers.dev/mcp

Конфигурация универсального клиента (всё, что поддерживает Streamable HTTP):

{
  "mcpServers": {
    "models-mcp": {
      "url": "https://models-mcp.<your-subdomain>.workers.dev/mcp"
    }
  }
}

Для клиентов, работающих только через stdio (Claude Desktop), используйте мост через mcp-remote:

{
  "mcpServers": {
    "models-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://models-mcp.<your-subdomain>.workers.dev/mcp"]
    }
  }
}

Никаких API-ключей нигде не требуется. Все данные берутся из публичной конечной точки models.dev/api.json.

Тесты

npm test

Покрывают клиент каталога (уплощение, TTL-кэширование, принудительное обновление, запасной вариант на устаревшие данные при сбое, разрешение идентификаторов) и все пять инструментов в комплексной проверке через реальную сессию MCP-клиента по транспорту в памяти.

Примечания к данным

• Каталог кэшируется на 1 час: в Workers Cache API при размещении и в памяти процесса при работе через stdio. Вызовите refresh_catalog, чтобы принудительно обновить. Если повторный запрос не удастся, будет продолжать отдаваться последний успешный каталог.

• models.dev не публикует версионированную схему для пользователейопросных, поэтому типы в src/types.ts намеренно слабые типизированные (индексные сигнатуры сохраняют любые поля, не описанные явно).

• Идентификаторы моделей используют соглашение provider/model, принятое в AI SDK и OpenCode, например anthropic/claude-sonnet-4-5. Инструменты get_model и compare_models также принимают голый идентификатор модели, если он не является неоднозначным среди провайдеров.

Возможные расширения

• Инструмент list_facets (модальности, токенизаторы), похожий на то, что предоставляют другие каталоги модельных задач.

• Инструмент test_model, который делает живой вызов через ваш настроенный ключ провайдера, для проверки задержки и стоимости.

• OAuth или Cloudflare Access перед Worker, если вы хотите сделать его приватным.