Currency MCP Agent

Локальный сервис для работы с валютными курсами и конвертацией через MCP и агентный слой. Решение разделяет доступ к инструментам и логику обработки пользовательского запроса.

Назначение

Принимать пользовательский запрос, определить необходимый инструмент, получить результат и вернуть структурированный ответ в едином формате.

Related MCP server: frankfurter-mcp

Архитектура

Пользовательский запрос
          │
          ▼
Агентный слой
          │
          ▼
MCP-сервер инструментов
     ┌────┴────┐
     ▼         ▼
Курсы валют  Конвертация
     └────┬────┘
          ▼
Структурированный ответ

Что реализовано

• агентный слой для выбора сценария обработки;

• MCP-сервер инструментов;

• получение курсов валют;

• конвертация суммы между валютами;

• локальный запуск через Docker Compose;

• тесты пользовательских сценариев.

Структура репозитория

• agent/ — логика маршрутизации запроса;

• mcp_server/ — инструменты и их интерфейсы;

• config/ — настройки;

• tests/ — тесты;

• Dockerfile — сборка контейнера;

• docker-compose.yml — локальный запуск.

Оценка качества

Контролируют:

• долю успешных вызовов инструментов;

• корректность конвертации;

• задержку ответа;

• покрытие тестами основных пользовательских сценариев.

Результаты

Прогон pytest tests/ на локальной машине: 9 тестов пройдено, время около 4.75 с (зависит от окружения).

Запуск

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

docker compose up --build

Ограничения

• устойчивость ответа зависит от источника курсов и формата данных;

• расширение числа инструментов требует единого контракта параметров и ответов;

• для рабочего сценария журналируют вызовы инструментов и результаты тестов.