Juhe Exchange Rates MCP Server

What is Juhe Exchange Rates MCP Server?

A Model Context Protocol server that enables large language models to query real-time global currency exchange rates. It integrates with the Juhe (聚合数据) exchange rate API and is designed for developers building LLM-powered applications that need live foreign exchange data.

How to use Juhe Exchange Rates MCP Server?

Install via uvx jexchange-mcp-server (recommended) or pip install jexchange-mcp-server and run python -m jexchange_mcp_server. Configure the environment variable JUHE_EXCHANGE_API_KEY with your API key from Juhe. The server exposes a single tool query_exchange_rates that accepts two required string parameters: from_code (source currency code, e.g., CNY) and to_code (target currency code, e.g., USD).

Key features of Juhe Exchange Rates MCP Server

• Queries real-time exchange rates between two currencies
• Uses standard three-letter currency codes (ISO 4217)
• Requires only a Juhe API key for authentication
• Can be run directly via uvx without manual installation
• Supports pip installation for traditional Python environments
• Debuggable with the MCP inspector

Use cases of Juhe Exchange Rates MCP Server

• Enabling an LLM assistant to answer live currency conversion questions
• Automating cross-border transaction calculations in a chat interface
• Building a financial data pipeline that fetches exchange rates on demand
• Providing current foreign exchange data for budgeting or travel tools

FAQ from Juhe Exchange Rates MCP Server

What environment variable is required?

JUHE_EXCHANGE_API_KEY must be set to a valid API key from the Juhe exchange rate API. You can obtain one at https://www.juhe.cn/docs/api/id/73.

How do I install and run the server?

You can run it directly with uvx jexchange-mcp-server (requires uv) or install it via pip install jexchange-mcp-server and execute python -m jexchange_mcp_server. Python 3.10 or higher is required.

What parameter does the tool require?

The query_exchange_rates tool requires two string parameters: from_code (the three‑letter ISO currency code of the currency you are converting from) and to_code (the code of the target currency).

Can I debug the server?

Yes. Use the MCP inspector with npx @modelcontextprotocol/inspector uvx jexchange-mcp-server or, if installed locally, npx @modelcontextprotocol/inspector uv run jexchange-mcp-server.

Where does the data come from?

Exchange rate data is fetched in real time from the Juhe (聚合数据) public API using the API key you provide. The server does not cache or store any exchange rate data locally.