SimpleMCP - Сервер инструментов для автомобилей

Сервер Model Context Protocol (MCP) на базе FastMCP, предоставляющий набор полезных инструментов для работы с автомобильными данными, расчёта транспортного налога и интеграции с Telegram.

📋 Возможности

🚗 Поиск автомобилей

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

🧮 Расчёт транспортного налога

• Расчёт транспортного налога в Москве для легковых автомобилей
• Поддержка налоговых лет с 2015 по 2025
• Актуальные ставки налога на основе мощности двигателя

📱 Telegram интеграция

• Отправка сообщений в Telegram через бота
• Поддержка длинных сообщений (до 4096 символов)

🛠 Доступные инструменты

search_cars_by_brand_model

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

Параметры:

• query (str): Строка поиска (марка/модель)
• limit (int, опционально): Максимальное количество результатов (по умолчанию 10)

Возвращает: Список автомобилей с информацией о марке, модели, цене в рублях и мощности двигателя.

transport_tax

Расчёт транспортного налога в Москве для легкового автомобиля.

Параметры:

• tax_year (int): Налоговый год (2015-2025)
• power (int): Мощность двигателя в лошадиных силах

Возвращает: Сумма налога в рублях.

send_message_to_telegram

Отправка сообщения в Telegram чат через бота.

Параметры:

• message (str): Текст сообщения для отправки

Возвращает: "OK" при успешной отправке или описание ошибки.

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

Локальный запуск

1. Убедитесь, что у вас установлен Python 3.12+
2. Установите зависимости:

pip install fastmcp

3. Запустите сервер:

fastmcp run main.py

Сервер будет доступен по адресу http://0.0.0.0:8000 с использованием SSE транспорта.

Развёртывание в облаке

Для развёртывания в облаке используйте: https://fastmcp.cloud

⚙️ Настройка

Переменные окружения

Для работы Telegram интеграции установите следующие переменные:

• TELEGRAM_BOT_TOKEN - токен вашего Telegram бота
• TELEGRAM_CHAT_ID - ID чата для отправки сообщений

База данных автомобилей

Сервер использует файл prices.csv с данными об автомобилях в следующем формате:

brand,model,price_rub,engine_power_hp
BAIC,BJ40,4199000,224
BYD,Atto 3,3199000,204

🔌 Подключение к GigaAgent

Для подключения к GigaAgent используйте следующую конфигурацию:

MCP_CONFIG = {
    "giga_tools": {
        "transport": "stdio",
        "command": "npx",
        "args": ["-y", "mcp-remote@latest", "https://gigachat.fastmcp.app/mcp"]
    }
}

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

SimpleMCP/
├── main.py           # Основной файл сервера
├── prices.csv        # База данных автомобилей
├── pyproject.toml    # Конфигурация проекта
├── README.md         # Документация
└── LICENSE           # Лицензия

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

Поиск автомобиля

# Поиск автомобилей BYD
results = search_cars_by_brand_model("BYD", limit=5)

Расчёт налога

# Расчёт транспортного налога для автомобиля мощностью 150 л.с. на 2025 год
tax = transport_tax(2025, 150)  # Результат: 5250 рублей

Отправка в Telegram

# Отправка уведомления
status = send_message_to_telegram("Найден автомобиль: BYD Seal за 4,799,000 рублей")

📊 Ставки транспортного налога

2015-2024 годы

• До 100 л.с.: 12 руб/л.с.
• 101-125 л.с.: 25 руб/л.с.
• 126-150 л.с.: 35 руб/л.с.
• 151-175 л.с.: 45 руб/л.с.
• 176-200 л.с.: 50 руб/л.с.
• 201-225 л.с.: 65 руб/л.с.
• 226-250 л.с.: 75 руб/л.с.
• Свыше 250 л.с.: 150 руб/л.с.

2025 год

• До 100 л.с.: 13 руб/л.с.
• 101-125 л.с.: 28 руб/л.с.
• 126-150 л.с.: 35 руб/л.с.
• 151-200 л.с.: 50 руб/л.с.
• 201-225 л.с.: 72 руб/л.с.
• 226-250 л.с.: 75 руб/л.с.
• Свыше 250 л.с.: 150 руб/л.с.

🤝 Вклад в проект

Мы приветствуем вклад в развитие проекта! Пожалуйста, создавайте issues и pull requests для улучшения функциональности.

📄 Лицензия

Проект распространяется под лицензией, указанной в файле LICENSE.