Juhe Exchange

Provides real-time global currency exchange rates via a model context protocol server with a query tool to fetch rates between two currencies.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "juhemcp-jexchange-mcp-server": {
      "command": "uvx",
      "args": [
        "jexchange-mcp-server"
      ],
      "env": {
        "JUHE_EXCHANGE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run the Juhe Exchange Rates MCP Server to query real-time currency exchange rates between any two currencies. By loading this server into your MCP client, you enable your large language model to fetch up-to-date rates on demand, empowering financial queries and context-aware calculations.

How to use

To use the Juhe Exchange Rates MCP Server, you start the MCP server locally (or in your environment) and connect your MCP client to it. You will interact with a single tool named query_exchange_rates that accepts two currency codes and returns the exchange rate between them. Use it in your MCP prompts to obtain the latest conversion rate from one currency to another.

Practical usage patterns include asking for the current rate from one currency to another before performing a conversion in your workflow, or embedding a live rate lookup in your assistant’s responses to provide contextually accurate results.

How to install

Prerequisites: you need Python 3.10 or higher if you plan to run the Python-based runtime, or you can run the server using the uvx runtime for a lightweight startup.

uvx jexchange-mcp-server

Alternatively, you can install the server via Pip and run it as a module.

pip install jexchange-mcp-server

python -m jexchange_mcp_server

Additional configuration notes

Environment variables: you must provide an API key for the Juhe data source. Set JUHE_EXCHANGE_API_KEY to your key value in the environment where the MCP server runs.

Configuration examples show how to wire the MCP server into your client environment using common runtimes. The key is to ensure the API key is available to the server process at runtime.

Common start commands are demonstrated for both the uvx-based setup and the Pip-based setup, and you should choose the one that matches your deployment method.

Security and tips

Keep your API key secure and do not expose it in client-side prompts or logs. If you rotate keys, update the environment where the MCP server runs accordingly.

If you encounter connectivity or data issues, verify that the server process is running, the API key is valid, and the host environment has network access to the Juhe data sources.

Available tools

query_exchange_rates

Query the exchange rate between two currencies by their three-letter codes. Requires from_code and to_code as input and returns a list of content types including text, images, or embedded resources.