# MCP Business Tools (MVP)
Версия: 0.1.0дав
Бэкенд для демонстрации автоматизации тестирования и утилит команды QA с интеграцией AI (LLM).
---
## Что делает проект
- Генерирует тест-кейсы (ручные и API) автоматически через LLM.
- Проверяет тесты на соответствие стандартам (Allure, AAA-паттерн).
- Создает события в календаре (демо или через Google Calendar).
- Отправляет письма (демо, требует SMTP).
- Возвращает тестовые данные, например курсы валют (демо).
Всё доступно через веб-API. Можно тестировать через Swagger UI или HTTP-запросы.
---
## Требования
- Python 3.10+
- pip
- venv (рекомендовано)
---
## Установка
git clone https://github.com/Saturnnnnnnnnnnn/mcp-business-tools.git cd mcp-ready-project-full python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
______________________________________________________________________
## 外部服务配置
文件 `.env` 已包含在项目的根 `.env.example`内容示例：
Сервер
HOST=0.0.0.0 PORT=8000 REQUEST_TIMEOUT=15
SMTP (если нужно)
SMTP_HOST=smtp.example.com SMTP_PORT=587 SMTP_USER=user@example.com SMTP_PASSWORD=yourpassword FROM_EMAIL=user@example.com
LLM для генерации тестов
EVOLUTION_API_TOKEN=ваш_ключ EVOLUTION_API_URL=https://foundation-models.api.cloud.ru/v1
Google Calendar (если нужно)
GOOGLE_CALENDAR_API_KEY=ваш_ключ GOOGLE_CALENDAR_CALENDAR_ID=primary
> 如果没有LLM令牌，人工智能测试生成将无法工作。SMTP和日历可以留空演示。
______________________________________________________________________
## 发射
python3 -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
- API `http://127.0.0.1:8000`
- Swagger用户界面： `http://127.0.0.1:8000/docs`
- 健康检查： `http://127.0.0.1:8000/health`
______________________________________________________________________
## 查询示例
### 1.通过人工智能生成手动测试
curl -X POST http://127.0.0.1:8000/generate/manual-tests \ -H "Content-Type: application/json" \ -d '{"product_description":"Demo product","owner":"QA Team","feature":"Login","count":3}'
### 2.通过OpenAPI生成API测试
curl -X POST http://127.0.0.1:8000/generate/api-tests \ -H "Content-Type: application/json" \ -d '{"openapi_url":"https://demo.openapi.url/spec.json"}'
### 3.验证代码是否符合标准
curl -X POST http://127.0.0.1:8000/validate/code \ -H "Content-Type: application/json" \ -d '{"code":"@allure.manual\nwith allure.step(\"Arrange\"):\n pass"}'
### 4.货币兑换（演示）
curl -X POST http://127.0.0.1:8000/tool/get_exchange_rate \ -H "Content-Type: application/json" \ -d '{"from_currency":"USD","to_currency":"RUB"}'
### 5.发送电子邮件（需要SMTP）
curl -X POST http://127.0.0.1:8000/tool/send_email \ -H "Content-Type: application/json" \ -d '{"to":"you@example.com","subject":"Test Email","body":"Hello from MCP"}'
### 6.在日历中创建事件（演示或谷歌日历）
curl -X POST http://127.0.0.1:8000/tool/create_calendar_event \ -H "Content-Type: application/json" \ -d '{"title":"Demo Event","start_iso":"2025-12-06T12:00:00","end_iso":"2025-12-06T13:00:00","description":"Demo"}'
______________________________________________________________________
## 特点
- 在代币存在的情况下，测试生成和代码验证通过人工智能（LLM）进行。
- 真正的外部服务（邮件，日历，汇率）只在配置时工作。
- 您可以根据需要连接SMTP、Google Calendar和货币API。
- 一切都准备好在哈卡顿示威。
______________________________________________________________________
## 项目结构
app/ # сервер, LLM-клиент и utils tests/ # тесты examples/ # примеры запросов и output requirements.txt start.sh .env # настройки внешних сервисов и LLM
______________________________________________________________________
作者：Hamza
哈卡顿项目，MVP版本。