Models MCP

AI 모델을 가격, 컨텍스트 창, 기능에 따라 검색, 비교, 조사합니다. models.dev 카탈로그(models.dev/api.json)를 기반으로 하는 MCP 서버로, 목록을 수동으로 유지하지 않아도 에이전트가 항상 최신 모델 데이터를 사용할 수 있습니다.

models.dev 자체는 MCP 서버를 제공하지 않고 JSON API와 이를 읽기 위한 TypeScript SDK만 제공합니다. 이 프로젝트가 그 공백을 메웁니다.

동일한 도구 코드로 두 가지 방식으로 실행됩니다:

• stdio(src/index.ts): 로컬 MCP 클라이언트용

• Cloudflare Worker(src/worker.ts): /mcp에서 원격 Streamable HTTP 엔드포인트로 제공

도구

설치

npm install
npm run build

stdio로 단독 실행 (테스트용)

npm start

stdio를 통해 MCP를 사용하므로 직접 출력이 거의 보이지 않습니다. MCP Inspector로 살펴보세요:

npx @modelcontextprotocol/inspector node dist/index.js

Cloudflare Workers에 호스팅

Worker 진입점(src/worker.ts)은 /mcp에서 Streamable HTTP로 동일한 도구를 제공하며, 다음과 같은 기능을 포함합니다:

• 카탈로그 캐싱: Workers Cache API(caches.default)에 1시간 TTL로 캐시되며 요청과 격리(isolate) 간에 공유됩니다.

• IP별 속도 제한: Workers rate limiting 바인딩을 통해 IP당 분당 60회 요청으로 제한되고, Cloudflare 위치별로 적용됩니다. 초과 요청은 Retry-After: 60과 함께 429 응답을 받습니다.

# 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 캐싱, 강제 새로고침, 실패 시 오래된 데이터 폴백, id 해석)와 다섯 가지 도구 전체를 인메모리 전송을 통한 실제 MCP 클라이언트 세션으로 종단 간(end-to-end) 테스트합니다.

데이터 참고 사항

• 카탈로그는 1시간 동안 캐시됩니다: 호스팅 시 Workers Cache API에, stdio에서는 프로세스 메모리에 캐시됩니다. refresh_catalog를 호출해 강제로 업데이트할 수 있습니다. 다시 가져오기가 실패하면 마지막으로 성공한 카탈로그를 계속 제공합니다.

• models.dev는 소비자용 버전 관리 스키마를 공개하지 않으므로 src/types.ts의 타입은 의도적으로 느슨합니다(인덱스 시그니처가 명시적으로 타입되지 않은 필드를 보존).

• 모델 id는 AI SDK와 OpenCode에서 사용하는 provider/model 규칙을 따릅니다(예: anthropic/claude-sonnet-4-5). get_model과 compare_models는 제공업체 간에 모호하지 않으면 모델 id만으로도 허용합니다.

가능한 확장

• 다른 모델 카탈로그 MCP가 제공하는 것과 유사한 list_facets 도구(모달리티, 토크나이저).

• 구성한 제공업체 키를 통해 실시간 호출을 수행하여 지연 및 비용 타당성 검사를 하는 test_model 도구.

• 비공개로 유지하려면 Worker 앞에 OAuth 또는 Cloudflare Access를 추가.