MCP_Server

Shubham-Dash2004/MCP_Server

3.2

If you are the rightful owner of MCP_Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A custom MCP server that integrates with Claude Desktop for real-time currency conversion.

Tools
1
Resources
0
Prompts
0

MCP_Server

A custom MCP (Model Context Protocol) server that integrates with Claude Desktop to provide real-time currency conversion. This project demonstrates how MCP servers can extend Claude’s capabilities beyond local chat — letting you run custom logic, call APIs, and connect external tools directly into your AI workflow.

🚀 Features

  • Custom MCP Server: Written in Node.js using the official @modelcontextprotocol/sdk.
  • Currency Conversion Tool: Convert between currencies using Exchange Rate API.
  • Claude Desktop Integration: Exposes the convertCurrency tool directly inside Claude.
  • Real-time Results: Converts USD → INR, EUR → USD, or any other supported pair instantly.
  • Error Handling: Gracefully handles unsupported currencies or API issues.

🧩 What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI apps (like Claude Desktop) communicate with external services via custom servers. Instead of relying only on the AI’s built-in knowledge, MCP allows developers to:

  • Extend Claude with custom tools.
  • Query APIs or databases.
  • Provide structured results back to the model.

In this project, MCP is used to let Claude query live currency exchange rates.

🛠️ Tech Stack

  • Backend: Node.js, MCP SDK (@modelcontextprotocol/sdk)
  • Language: JavaScript (ESM with zod validation)
  • Transport: StdioServerTransport for Claude integration
  • API: open.er-api.com

📂 Project Structure

currency-converter-mcp/
├── currencyConverter.js   # MCP server implementation
├── package.json           # Node.js dependencies
└── README.md              # Project documentation

⚙️ Setup Instructions

1. Clone Repo

git clone <your-repo-url>
cd currency-converter-mcp

2. Install Dependencies

npm install

3. Add to Claude Config

Edit the file:

  • Windows: C:\Users\<YourName>\AppData\Roaming\Claude\claude_desktop_config.json
  • Mac/Linux: ~/.config/Claude/claude_desktop_config.json

Add:

{
  "mcpServers": {
    "currency-converter": {
      "command": "node",
      "args": ["C:/path/to/currencyConverter.js"]
    }
  }
}

4. Restart Claude Desktop

Fully quit and reopen Claude Desktop. You should now see the currency-converter MCP server active.

🔑 Usage in Claude

Once the MCP server is running, you can chat with Claude like this:

Prompt Example:

Use the convertCurrency tool to convert 100 USD to INR.

Claude Response:

100 USD ≈ 8,360.00 INR

🧠 How Claude + MCP Helped

  • Claude acts as the AI reasoning engine.
  • MCP server acts as a tool provider (currency conversion).
  • Together, they enable real-time, API-backed answers instead of relying on static knowledge.

This approach can be extended to databases, sensors, custom APIs, or business workflows.

🔮 Future Ideas

  • Support historical rates (date-based conversion).
  • Add batch conversions (convert to multiple currencies at once).
  • Connect with financial APIs (forex, crypto).
  • Build a web UI in parallel with Claude integration.

📜 License

MIT License. Free to use and modify.

🤝 Contributing

Pull requests welcome! If you extend this server with more tools, feel free to share.