mirror of
https://github.com/alibaba/higress.git
synced 2026-05-04 02:17:27 +08:00
47 lines
3.4 KiB
Markdown
47 lines
3.4 KiB
Markdown
# 汇率查询
|
||
|
||
API认证需要的APP Code请在阿里云API市场申请: https://market.aliyun.com/apimarket/detail/cmapi011221
|
||
|
||
## 什么是云市场API MCP服务
|
||
|
||
阿里云云市场是生态伙伴的交易服务平台，我们致力于为合作伙伴提供覆盖上云、商业化和售卖的全链路服务，帮助客户高效获取、部署和管理优质生态产品。云市场的API服务涵盖以下几个类目：应用开发、身份验证与金融、车辆交通与物流、企业服务、短信与运营商、AI应用与OCR、生活服务。
|
||
云市场API依托Higress提供MCP服务，您只需在云市场完成订阅并获取AppCode，通过Higress MCP Server进行配置，即可无缝集成云市场API服务。
|
||
|
||
## 如何在使用云市场API MCP服务
|
||
|
||
1. 进入API详情页，订阅该API。您可以优先使用免费试用。
|
||
2. 前往云市场用户控制台，使用阿里云账号登陆后查看已订阅API服务的AppCode，并配置到Higress MCP Server的配置中。注意：在阿里云市场订阅API服务后，您将获得AppCode。对于您订阅的所有API服务，此AppCode是相同的，您只需使用这一个AppCode即可访问所有已订阅的API服务。
|
||
3. 云市场用户控制台会实时展示已订阅的预付费API服务的可用额度，如您免费试用额度已用完，您可以选择重新订阅。
|
||
|
||
# MCP服务器功能简介文档
|
||
|
||
## 功能简介
|
||
本MCP服务器名为`exchange-rate-query`，主要提供外汇牌价查询及汇率转换服务。通过与阿里云市场中的汇率API对接，能够为用户提供包括但不限于十大银行外汇牌价、单个货币与其他货币间的汇率、所有支持的货币名称以及具体的汇率转换等信息。此服务对于需要实时获取最新汇率数据的应用场景尤为适用，如金融分析软件、国际贸易平台或个人理财助手。
|
||
|
||
## 工具简介
|
||
|
||
### 十大银行的外汇牌价
|
||
- **用途**：该工具允许用户查询中国十大主要银行提供的外汇牌价。
|
||
- **使用场景**：适用于需要了解不同银行之间外汇价格差异的情况，比如进行国际汇款前比较各银行手续费和汇率以选择最优方案。
|
||
- **参数说明**：
|
||
- `bank`：指定查询的银行编码，默认为中国银行（BOC）。
|
||
|
||
### 单个货币查询接口
|
||
- **用途**：用于获取特定货币相对于其他多种货币的当前汇率及其最后更新时间。
|
||
- **使用场景**：当需要针对某一种基础货币查看其对世界范围内其他货币的价值时非常有用。
|
||
- **参数说明**：
|
||
- `currency`：必需参数，指明要查询的基础货币代码。
|
||
|
||
### 所有货币查询接口
|
||
- **用途**：列出系统支持的所有货币及其对应的全称。
|
||
- **使用场景**：在构建涉及多币种交易的应用程序时，作为初始化步骤之一来获取完整的货币列表。
|
||
- **参数说明**：无额外输入参数。
|
||
|
||
### 汇率转换接口
|
||
- **用途**：根据给定的数量将一个单位的货币价值转换成另一个单位。
|
||
- **使用场景**：非常适合那些需要快速计算跨国交易中不同货币间价值转换的应用场合。
|
||
- **参数说明**：
|
||
- `amount`：必填项，表示要转换的金额数。
|
||
- `from`：必填项，源货币代码；如果为空，则默认采用人民币（CNY）或者美元（USD）。
|
||
- `to`：必填项，目标货币代码；同样地，若未指定则默认取CNY或USD作为输出货币。
|