currency-history-mcp 0.1.0

A Model Context Protocol (MCP) server for fetching historical currency exchange rates using the Frankfurter API.

Currency History MCP

A Model Context Protocol (MCP) server that provides historical currency exchange rates and currency conversion. Powered by the Frankfurter API, which is free and open-source.

Features

• Get Historical Rates: Fetch exchange rates for a specific date (e.g., "2023-01-01").
• Convert Currency: Convert amounts between currencies using historical rates.

Installation & Usage (with uv)

You can run this MCP server directly using uv without manually installing it everywhere:

# Run directly
uvx currency-history-mcp

Or install it as a tool:

uv tool install currency-history-mcp

Manual Installation

pip install currency-history-mcp

Running the Server

# If installed via pip
currency-history-mcp

# Or connect via an MCP client inspector
npx @modelcontextprotocol/inspector uvx currency-history-mcp

Tools

1. get_historical_rate

   • date: YYYY-MM-DD
   • base: Base currency (default USD)
   • symbols: Target currencies (default CNY, EUR, JPY, GBP)

2. convert_historical_amount

   • amount: Amount to convert
   • from_curr: Source currency
   • to_curr: Target currency
   • date: YYYY-MM-DD