Currency MCP Agent

Локальный сервис для работы с валютными курсами и конвертацией через 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

Ограничения

• устойчивость ответа зависит от источника курсов и формата данных;
• расширение числа инструментов требует единого контракта параметров и ответов;
• для рабочего сценария журналируют вызовы инструментов и результаты тестов.