CalculatorLib MCP

Cài đặt trong 60 giây

Chọn client bạn dùng, dán đoạn mã, khởi động lại. Vậy là xong.

Claude Code Claude Desktop Cursor Zed Cline Windsurf Khác / tổng quát

claude mcp add --transport http calculatorlib https://calculatorlib.com/mcp

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "context_servers": {
    "calculatorlib": {
      "source": "custom",
      "transport": {
        "type": "streamable-http",
        "url": "https://calculatorlib.com/mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "transportType": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "calculatorlib": {
      "serverUrl": "https://calculatorlib.com/mcp"
    }
  }
}

{
  "transport": "streamable-http",
  "endpoint": "https://calculatorlib.com/mcp"
}

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Thử các câu lệnh sau

Sau khi cài đặt, cứ trò chuyện với Claude bằng ngôn ngữ tự nhiên — Claude sẽ tự chọn đúng công cụ.

Khu thử nghiệm trực tiếp

Gọi máy chủ ngay tại đây — JSON-RPC thật tới https://calculatorlib.com/mcp, phản hồi thật. Không cần đăng ký. đang tải công cụ…

Trình duyệt công cụ

Tìm trong thư viện máy tính và 9 nhóm chuyển đổi theo tên hoặc tiêu đề. Hữu ích khi bạn muốn biết nên hỏi Claude điều gì.

Cách hoạt động

• Endpoint: một handler POST duy nhất tại https://calculatorlib.com/mcp dùng JSON-RPC 2.0 qua Streamable HTTP (đặc tả giao thức truyền 2025-06-18).
• Quy ước đặt tên công cụ: slug của máy tính dùng snake_case (bmi_calculator, compound_interest_calculator); bộ chuyển đổi có dạng convert_<category>.
• Đầu vào: mỗi công cụ cung cấp một JSON Schema suy ra từ các trường biểu mẫu của máy tính (kiểu, enum, min/max). Các trường có điều kiện (ví dụ hệ mét và hệ Anh trong BMI) được liệt kê là tùy chọn — hãy đọc mô tả của từng trường để biết tổ hợp nào hợp lệ.
• Đầu ra: một dòng tóm tắt dạng văn bản, kèm một đối tượng JSON structuredContent mà LLM có thể phân tích (ví dụ { "main": [{...}], "data": [...] }).
• Cập nhật: danh mục làm mới mỗi 5 phút — máy tính vừa xuất bản sẽ tự động xuất hiện.

API trực tiếp (không cần client MCP)

Muốn tích hợp mà không cần client MCP? Cùng dữ liệu đó được cung cấp qua các endpoint JSON thuần.

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"bmi_calculator",
      "arguments":{"unitSystem":"metric","weight":70,"height":170}
    }
  }'

curl -X POST https://calculatorlib.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{
      "name":"convert_length",
      "arguments":{"value":5,"from":"Meter","to":"Foot"}
    }
  }'

Các endpoint REST (không có lớp bọc JSON-RPC):

• /api/calculators/schemas?q=<keywords> — tìm máy tính (kết quả giới hạn, kèm schema đầu vào)
• /api/converter/categories — các nhóm chuyển đổi kèm đơn vị
• POST /api/converter/convert — chuyển đổi trực tiếp, với body { category, from, to, value }

Xác thực (tùy chọn nhưng nên dùng)

Lệnh gọi ẩn danh vẫn hoạt động — xác thực chỉ là tùy chọn. Thêm token sẽ mở khóa thống kê sử dụng theo từng người dùng tại /account/mcp-logs: mọi lệnh gọi qua token sẽ hiển thị ở đó kèm độ trễ, lý do lỗi và máy tính bạn đã gọi.

Lấy token (60 giây)

1. Đăng nhập (hoặc tạo tài khoản trước).
2. Vào /account/api-tokens.
3. Nhấn Generate token. Sao chép giá trị — token chỉ hiển thị duy nhất một lần.

Thêm token vào client MCP của bạn

Vẫn dùng tệp cấu hình như khi cài đặt công khai, bổ sung thêm trường headers.Authorization:

{
  "mcpServers": {
    "calculatorlib": {
      "url": "https://calculatorlib.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Vì sao nên dùng?

• Nhật ký sử dụng cá nhân — xem bạn gọi máy tính nào nhiều nhất và máy nào bị lỗi, chỉ trong phạm vi token của bạn (/account/mcp-logs).
• Nhiều client, token riêng biệt — tạo riêng một token cho mỗi thiết bị (laptop, máy chủ, agent). Thu hồi một token không ảnh hưởng các token còn lại.
• Nền tảng cho các tính năng cá nhân hóa sau này — khi bổ sung giới hạn tần suất / hạn mức / preset đã lưu, chúng sẽ gắn với các lệnh gọi đã xác thực.

curl với token Bearer

curl -X POST https://calculatorlib.com/mcp \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Dành cho người vận hành máy chủ: đặt MCP_REQUIRE_AUTH=true để bắt buộc mọi lệnh gọi phải có token (ẩn danh → 401). Biến môi trường cũ MCP_API_TOKEN vẫn dùng được như một khóa bí mật dùng chung để bỏ qua xác thực.

Câu hỏi thường gặp & xử lý sự cố