TokenLab MCP Server

​

Những gì nó cung cấp

• Khám phá mô hình trực tiếp từ https://api.tokenlab.sh/v1/models.
• Tra cứu chi tiết mô hình từ /v1/models/{model}.
• Tra cứu giá cả từ /v1/models/{model}/pricing.
• Tổng quan API mà tác nhân có thể đọc được từ https://api.tokenlab.sh/llms.txt.
• Chat Completions và Responses tương thích với OpenAI, Anthropic Messages và Gemini generateContent mà không làm phẳng cấu trúc yêu cầu gốc của chúng.
• Tạo và chỉnh sửa hình ảnh thông qua URL JSON, ID tệp tin TokenLab hoặc các tệp multipart cục bộ.
• Video, âm nhạc, 3D, giọng nói, phiên âm, dịch âm thanh, embedding, embedding đa phương thức, rerank và dịch văn bản.
• Tóm tắt tác vụ bất đồng bộ đã chuẩn hóa cho các hoạt động tạo hình ảnh, video, âm nhạc, 3D và thế giới.
• Đồng bộ hóa hợp đồng hàng ngày giúp lấy tài liệu OpenAPI công khai, tạo lại lược đồ công cụ, chạy các bài kiểm tra endpoint và tệp tin, và chỉ cập nhật main khi mọi kiểm tra đều vượt qua.

​

Bắt đầu nhanh

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" }
    }
  }
}

# Danh mục công khai
codex mcp add --env TOKENLAB_MCP_TOOL_PROFILE=catalog tokenlab-model-catalog -- npx -y @tokenlabai/mcp-server

# Cấu hình core mặc định với khóa 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

​

Tham chiếu cấu hình

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

​

Cài đặt từ mã nguồn

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

​

Các cấu hình công cụ được tạo sẵn

​

Kết quả phương tiện bất đồng bộ

​

Quy trình làm việc khuyến nghị cho tác nhân

1. Gọi list_models khi người dùng chưa đặt tên cho mô hình.
2. Sử dụng recommended_for cho các tác vụ không phải trò chuyện, chẳng hạn như hình ảnh, video, âm nhạc, 3D, TTS, STT, embedding, rerank hoặc dịch thuật.
3. Gọi get_model trước khi xây dựng một yêu cầu không phải trò chuyện, thử lại một yêu cầu thất bại hoặc chuyển đổi các nhóm endpoint.
4. Gọi get_model_pricing khi chi phí mô hình ảnh hưởng đến lựa chọn của người dùng.
5. Sử dụng compare_models khi lựa chọn phụ thuộc vào một vài ứng viên.
6. Gọi công cụ được tạo sẵn khớp với hợp đồng API yêu cầu, hoặc sử dụng get_api_overview để có bản đồ thu gọn của các nhóm API TokenLab.

​

Hướng dẫn về Endpoint gốc

​

Trình khám phá mô hình được lưu trữ

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

​

Sử dụng với các kỹ năng TokenLab

• MCP server: khám phá các mô hình hiện tại, giá cả và chi tiết endpoint.
• Kỹ năng tokenlab-api-integration: tạo các ví dụ API có thể chạy được và xử lý các lỗi TokenLab có cấu trúc.
• Kỹ năng tokenlab-model-picker: chọn các mô hình mạnh mẽ cho tác vụ của người dùng.
• Kỹ năng tokenlab-native-endpoints: quyết định khi nào nên sử dụng các tuyến đường Responses, Anthropic Messages, Gemini, phương tiện, âm thanh, embedding, rerank hoặc dịch thuật.

​

Khắc phục sự cố

​

Tài nguyên