Frankfurter MCP
Có câu hỏi hoặc gặp sự cố? Hãy đăng trên GitHub Discussions.
Quy đổi tiền tệ và tra cứu tỷ giá hiện tại hoặc lịch sử ngay từ trợ lý AI của bạn, thông qua MCP server chính thức (Model Context Protocol). Dữ liệu hàng ngày có từ năm 1948.
Thêm https://mcp.frankfurter.dev/ làm HTTP server từ xa. Không cần khóa API hay đăng ký.
ChatGPT
- Mở Settings, rồi chọn Apps (hoặc Connectors).
- Ở góc trên bên phải, nhấp Advanced settings và bật Developer mode để cho phép ứng dụng tùy chỉnh.
- Quay lại menu con Apps, nhấp Create app (hoặc Create connector).
- Nhập URL của endpoint:
https://mcp.frankfurter.dev/. - Ở phần xác thực (authentication), chọn None.
Claude
Trong Claude Code:
claude mcp add frankfurter https://mcp.frankfurter.dev/
Trong Claude Desktop hoặc Claude.ai:
- Mở Settings, rồi chọn Connectors.
- Nhấp Add custom connector.
- Nhập URL của endpoint:
https://mcp.frankfurter.dev/. - Nhấp Add để hoàn tất. Sau khi kết nối, hãy bật connector trong giao diện trò chuyện.
Client khác
Thêm vào cấu hình MCP của bạn (Cursor, Windsurf, VS Code, v.v.):
{
"mcpServers": {
"frankfurter": {
"url": "https://mcp.frankfurter.dev/"
}
}
}
Công cụ
Sau khi kết nối, trợ lý của bạn có thể dùng các công cụ sau:
convert-
Quy đổi một số tiền giữa hai tiền tệ. Theo mặc định chỉ trả về số tiền đã quy đổi và tiền tệ của nó.
Đặt
details: trueđể trả về thêm tỷ giá, ngày hiệu lực và nguồn, nếu có chọn nguồn.
Tham số:amount(số, bắt buộc): Số tiền cần quy đổi.from(chuỗi, bắt buộc): Mã tiền tệ hoặc tài sản nguồn (ví dụUSD,XAUhoặcBTC).to(chuỗi, bắt buộc): Mã tiền tệ hoặc tài sản đích (ví dụEUR).date(chuỗi, tùy chọn): Một ngày cụ thểYYYY-MM-DDđể quy đổi theo tỷ giá lịch sử.provider(chuỗi, tùy chọn): Khóa của một nguồn (ví dụECBhoặcUST), để dùng tỷ giá do một tổ chức công bố thay vì tỷ giá tổng hợp. Với nguồn công bố hàng tuần, hàng tháng hoặc hàng quý, một ngày nằm trong kỳ sẽ trả về tỷ giá đang có hiệu lực.details(boolean, tùy chọn): Kèm tỷ giá, ngày hiệu lực và nguồn đã chọn (mặc định:false). Quy đổi cùng một tiền tệ trả về tỷ giá1và ngàynull, không có nguồn.
get_rates-
Tra cứu tỷ giá tham chiếu.
Tham số:date(chuỗi, tùy chọn): Ngày của tỷ giáYYYY-MM-DD(mặc định là mới nhất).base(chuỗi, tùy chọn): Mã tiền tệ hoặc tài sản cơ sở (mặc định:EUR).quotes(chuỗi hoặc mảng, tùy chọn): Lọc kết quả theo mã tiền tệ hoặc tài sản.provider(chuỗi hoặc mảng, tùy chọn): Một hoặc nhiều khóa nguồn. Khi dùng tiền tệ cơ sở của chính nguồn đó, các chữ số giữ nguyên như khi công bố, kèm ngày bắt đầu có hiệu lực.
providersvẫn được chấp nhận. Hãy dùngproviderhoặcproviders, không dùng cả hai. list_currencies-
Tìm các mã tiền tệ, kim loại quý và tài sản mã hóa được hỗ trợ cùng tên của chúng, bao gồm cả tiền tệ đã ngừng lưu hành.
Bỏ bộ lọc để liệt kê mọi mã.
Tham số:query(chuỗi, tùy chọn): Một mã hoặc một phần tên, không phân biệt hoa thường. Mã khớp chính xác được ưu tiên hơn khớp một phần.
list_providers-
Tìm các nguồn, kèm khóa, loại tỷ giá, tần suất và khoảng ngày có dữ liệu, để chọn một
provider. Nguồn công bố nhiều chuỗi cũng liệt kê các bộ dữ liệu của mình; truyền một khóa bộ dữ liệu nhưNBP.Blàmproviderđể chọn bộ đó. Các bộ lọc kết hợp với nhau và không phân biệt hoa thường. Bỏ chúng để liệt kê mọi nguồn.
Tham số:query(chuỗi, tùy chọn): Khóa nguồn hoặc một phần tên. Khóa khớp chính xác được ưu tiên hơn khớp một phần.country(chuỗi, tùy chọn): Mã quốc gia gồm hai chữ cái (ví dụUS).currency(chuỗi, tùy chọn): Một mã tiền tệ được hỗ trợ, kể cả tiền tệ cơ sở của nguồn.
Nếu cần chuỗi thời gian, khoảng lịch sử hoặc dữ liệu số lượng lớn, hãy dùng REST API.