mcp-currency-server

522jack/mcp-currency-server

3.1

If you are the rightful owner of mcp-currency-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 dayong@mcphub.com.

Currency MCP Server provides currency exchange rates based on country codes.

Tools
1
Resources
0
Prompts
0

Currency MCP Server

MCP (Model Context Protocol) сервер для получения курса валюты по коду страны.

Описание

Этот сервер предоставляет инструмент для определения валюты страны по её коду и получения актуального курса обмена. Сервер:

  1. Принимает код страны (ISO 3166-1 alpha-2, например 'US', 'GB', 'RU')
  2. Определяет валюту страны
  3. Получает текущий курс обмена валюты через Exchange Rate API

Возможности

Инструменты (Tools)

  • get_currency_by_country - Получить информацию о валюте и курсе обмена для страны
    • Параметры:
      • country_code (обязательный) - Код страны ISO 3166-1 alpha-2 (например, "US", "GB", "RU", "JP", "DE")
      • target_currency (опциональный) - Целевая валюта для конвертации (по умолчанию "USD")

Требования

  • Java 17 или выше
  • Интернет соединение (для API запросов к Exchange Rate API)

Установка и запуск

1. Сборка проекта

cd /Users/evgeniy/Desktop/Projects/mcp-currency-server
./gradlew build

2. Создание fat JAR

./gradlew fatJar

Это создаст JAR файл в build/libs/mcp-currency-server-1.0.0.jar

3. Запуск сервера

Сервер поддерживает два режима работы:

STDIO режим (для Claude Desktop)
java -jar build/libs/mcp-currency-server-1.0.0.jar
# или явно
java -jar build/libs/mcp-currency-server-1.0.0.jar stdio
SSE/HTTP режим (для Android и веб-приложений)
# Запуск на порту 3000 (по умолчанию)
java -jar build/libs/mcp-currency-server-1.0.0.jar sse

# Запуск на другом порту
java -jar build/libs/mcp-currency-server-1.0.0.jar sse 8080

Сервер будет доступен по адресу http://localhost:3000 с endpoints:

  • GET /health - проверка работоспособности
  • GET /info - информация о сервере
  • POST /mcp - JSON-RPC запросы
  • GET /sse - SSE соединение
  • POST /message - отправка сообщений в SSE сессию

Использование с Claude Desktop

Добавьте следующую конфигурацию в файл Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "currency": {
      "command": "java",
      "args": [
        "-jar",
        "/Users/evgeniy/Desktop/Projects/mcp-currency-server/build/libs/mcp-currency-server-1.0.0.jar"
      ]
    }
  }
}

После этого перезапустите Claude Desktop.

Примеры использования

В Claude Desktop вы можете спросить:

  • "Какая валюта используется в Японии (JP) и какой у неё курс к доллару?"
  • "Покажи курс валюты для России (RU)"
  • "What is the currency exchange rate for Great Britain (GB) to EUR?"
  • "Покажи курс валюты для Германии (DE)"

Пример ответа

💱 Currency Information

🌍 Country: United Kingdom (GB)
💵 Currency: British Pound (GBP)

📊 Exchange Rate:
   1 GBP = 1.2534 USD
   1 USD = 0.7978 GBP

💡 Example conversions:
   100 GBP = 125.34 USD
   100 USD = 79.78 GBP

Поддерживаемые страны и валюты

Сервер поддерживает более 50 стран и их валют, включая:

Основные валюты

  • US - United States (USD)
  • GB - United Kingdom (GBP)
  • JP - Japan (JPY)
  • RU - Russia (RUB)
  • CN - China (CNY)
  • CA - Canada (CAD)
  • AU - Australia (AUD)
  • CH - Switzerland (CHF)
  • IN - India (INR)

Еврозона (EUR)

DE, FR, IT, ES, NL, BE, AT, PT, GR, FI, IE, SK, SI, LT, LV, EE, CY, MT, LU

Азия

  • JP - Japan (JPY)
  • CN - China (CNY)
  • KR - South Korea (KRW)
  • SG - Singapore (SGD)
  • HK - Hong Kong (HKD)
  • TW - Taiwan (TWD)
  • TH - Thailand (THB)
  • MY - Malaysia (MYR)
  • ID - Indonesia (IDR)
  • PH - Philippines (PHP)
  • VN - Vietnam (VND)

Другие регионы

  • BR - Brazil (BRL)
  • MX - Mexico (MXN)
  • AR - Argentina (ARS)
  • ZA - South Africa (ZAR)
  • TR - Turkey (TRY)
  • AE - UAE (AED)
  • SA - Saudi Arabia (SAR)
  • EG - Egypt (EGP)

И многие другие...

Разработка

Структура проекта

mcp-currency-server/
├── src/main/kotlin/com/claude/mcp/currency/
│   ├── Main.kt                    # Точка входа
│   ├── CurrencyService.kt         # Сервис работы с валютой
│   ├── McpServerHandler.kt        # Обработчик MCP протокола
│   ├── StdioTransport.kt          # STDIO транспорт (для Claude Desktop)
│   ├── SseTransport.kt            # SSE/HTTP транспорт (для Android/Web)
│   └── protocol/
│       └── McpProtocol.kt         # MCP протокол
├── build.gradle.kts               # Gradle конфигурация
├── README.md                      # Документация
└── ANDROID_INTEGRATION.md         # Android интеграция

Используемые API

Exchange Rate API - для получения курсов валют

  • Endpoint: https://api.exchangerate-api.com/v4/latest/{currency}
  • Бесплатный API без необходимости регистрации
  • Поддерживает все основные мировые валюты

Коды стран (ISO 3166-1 alpha-2)

Используйте двухбуквенные коды стран:

  • US - United States
  • GB - Great Britain
  • RU - Russia
  • DE - Germany
  • FR - France
  • JP - Japan
  • CN - China
  • И т.д.

Полный список доступен на https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

Интеграция с Android приложением

Сервер поддерживает SSE/HTTP режим для подключения с Android приложений.

См. полную документацию и примеры кода:

Быстрый старт для Android:

  1. Запустите сервер в SSE режиме:
java -jar build/libs/mcp-currency-server-1.0.0.jar sse 3000

  1. Используйте HTTP клиент (OkHttp, Retrofit) для запросов к http://<server-ip>:3000/mcp

  2. Пример запроса:

// POST http://192.168.1.100:3000/mcp
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_currency_by_country",
    "arguments": {
      "country_code": "RU"
    }
  }
}

Логирование

Логи выводятся в stderr. Уровень логирования можно настроить в src/main/resources/logback.xml

Лицензия

MIT