TokenLab MCP 서버

​

제공 기능

• https://api.tokenlab.sh/v1/models를 통한 실시간 모델 검색.
• /v1/models/{model}을 통한 모델 세부 정보 조회.
• /v1/models/{model}/pricing을 통한 가격 조회.
• https://api.tokenlab.sh/llms.txt를 통한 에이전트 가독형 API 개요.
• OpenAI 호환 채팅 완료(Chat Completions) 및 응답, Anthropic 메시지, Gemini generateContent를 네이티브 요청 형태 그대로 지원.
• JSON URL, TokenLab 파일 ID 또는 로컬 멀티파트 파일을 통한 이미지 생성 및 편집.
• 비디오, 음악, 3D, 음성, 전사(transcription), 오디오 번역, 임베딩, 멀티모달 임베딩, 리랭크 및 텍스트 번역.
• 이미지, 비디오, 음악, 3D 및 월드 생성 작업을 위한 정규화된 비동기 작업 요약.
• 공개 OpenAPI 문서를 가져와 도구 스키마를 재생성하고, 엔드포인트 및 파일 테스트를 실행하며, 모든 검사가 통과될 때만 main을 업데이트하는 일일 계약 동기화.

​

빠른 시작

node --version
npx --version

claude mcp add --env TOKENLAB_MCP_TOOL_PROFILE=catalog --scope user tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server

claude mcp add --env TOKENLAB_API_KEY=your-tokenlab-api-key --scope user tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server

{
  "mcpServers": {
    "tokenlab-model-catalog": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server"],
      "env": { "TOKENLAB_MCP_TOOL_PROFILE": "catalog" }
    }
  }
}

{
  "servers": {
    "tokenlab-model-catalog": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server"],
      "env": { "TOKENLAB_MCP_TOOL_PROFILE": "catalog" }
    }
  }
}

# 공개 카탈로그
codex mcp add --env TOKENLAB_MCP_TOOL_PROFILE=catalog tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server

# 기본 core 프로필과 API 키
codex mcp add --env TOKENLAB_API_KEY=your-tokenlab-api-key tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server

cline mcp add tokenlab --yes -- npx -y @tokenlabai/mcp-server

claude mcp list
codex mcp list

​

구성 참고

{
  "mcpServers": {
    "tokenlab-model-catalog": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server"],
      "env": {
        "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
        "TOKENLAB_MCP_TOOL_PROFILE": "core"
      }
    }
  }
}

​

소스에서 설치

git clone https://github.com/hedging8563/tokenlab-mcp-server.git
cd tokenlab-mcp-server
npm install
npm test
npm start

​

생성된 도구 프로필

​

비동기 미디어 결과

​

권장 에이전트 워크플로우

1. 사용자가 모델을 지정하지 않은 경우 list_models를 호출합니다.
2. 이미지, 비디오, 음악, 3D, TTS, STT, 임베딩, 리랭크 또는 번역과 같은 비채팅 작업에는 recommended_for를 사용합니다.
3. 비채팅 요청을 생성하거나, 실패한 요청을 재시도하거나, 엔드포인트 제품군을 전환하기 전에 get_model을 호출합니다.
4. 모델 비용이 사용자의 선택에 영향을 미치는 경우 get_model_pricing을 호출합니다.
5. 선택이 여러 후보에 따라 달라지는 경우 compare_models를 사용합니다.
6. 필요한 API 계약과 일치하는 생성된 도구를 호출하거나, TokenLab API 제품군의 간략한 지도를 보려면 get_api_overview를 사용합니다.

​

네이티브 엔드포인트 가이드

​

호스팅된 모델 탐색기

https://tokenlab-model-explorer.vercel.app/mcp

​

TokenLab 스킬과 함께 사용

• MCP 서버: 현재 모델, 가격 및 엔드포인트 세부 정보를 검색합니다.
• tokenlab-api-integration 스킬: 실행 가능한 API 예제를 생성하고 구조화된 TokenLab 오류를 처리합니다.
• tokenlab-model-picker 스킬: 사용자의 작업에 적합한 강력한 모델을 선택합니다.
• tokenlab-native-endpoints 스킬: 응답, Anthropic 메시지, Gemini, 미디어, 오디오, 임베딩, 리랭크 또는 번역 경로를 사용할 시기를 결정합니다.

​

문제 해결

​

리소스