Currency Converter MCP Server

💱 Currency Converter MCP Server A simple Model Context Protocol (MCP) server built with Node.js that provides a currency conversion tool and can be connected to Claude Desktop.

Features

• Currency conversion through an MCP tool

• Works with Claude Desktop

• Built using the official MCP TypeScript/JavaScript SDK

• Uses stdio transport

• Input validation with Zod

• Simple and easy-to-extend project structure

Related MCP server: Realtime Exchange Rate MCP Server

Tech Stack

• Node.js

• JavaScript (ES Modules)

• Model Context Protocol (MCP)

• @modelcontextprotocol/sdk

• Zod

• Claude Desktop

Project Structure

MCP Server/
├── currencyConvertered.js
├── package.json
├── package-lock.json
├── image/
│   └── image.png
└── README.md

Screenshot

Project Structure in VS Code

The screenshot shows the MCP Server project structure in VS Code, including the image folder and image.png file.

Installation

Open PowerShell/Terminal inside the project folder:

npm install

Run the Server

npm start

You should see:

MCP Currency Converter Server started

MCP Tool

The server provides the following tool:

convertCurrency

Converts an amount from one currency to another.

Example input:

amount: 100
from: USD
to: INR

Example output:

100 USD = 8800.00 INR

Note: The current demo uses a hardcoded exchange rate of 88. It is not a live exchange-rate API.

Claude Desktop Configuration

Add the following configuration to the Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "currency-converter": {
      "command": "node",
      "args": [
        "C:\Users\Harsh Vardhan Maurya\OneDrive\Desktop\MCP Server\currencyConvertered.js"
      ]
    }
  }
}

After saving the configuration, restart Claude Desktop.

Then open:

Settings → Developer

You should see:

currency-converter — Running

Testing

In Claude Desktop, try:

Convert 100 USD to INR using the currency converter.

The MCP server will call the convertCurrency tool and return the converted amount.

Future Improvements

• Add a live exchange-rate API

• Support more currencies

• Add currency validation

• Add error handling for unsupported currencies

• Add more MCP tools

Author

Harsh Vardhan Maurya

License

ISC