ВяткинАртём
2817cf8dc6
- Created a test coverage checklist to ensure comprehensive testing of backend and frontend components. - Added a test report template to standardize reporting on test execution results and gaps. - Introduced a test stack matrix to guide the selection of testing tools and frameworks for backend and frontend. - Established a skill for repairing failing tests, including a failure triage checklist and a test repair template. - Documented recommended MCP stack for ecommerce development with FastAPI and React/Next.js. - Developed a detailed README outlining the project structure, agent capabilities, and recommended workflows. - Compiled a comprehensive workflow guide detailing step-by-step commands for project setup, testing, and SEO implementation.
7.6 KiB
7.6 KiB
Рекомендуемый стек MCP
Этот файл описывает рекомендуемый набор MCP для ecommerce-разработки на FastAPI + React или Next.js.
Приоритет 1: добавить в первую очередь
1. Context7 или docs MCP
- Назначение: получать актуальную документацию и примеры по FastAPI, SQLAlchemy, Pydantic, Next.js, React, Playwright, pytest, Alembic и связанным инструментам.
- Почему это важно: снижает риск устаревших решений и помогает агенту ориентироваться на реальные версии библиотек.
- Лучше всего подходит для: архитектурных решений, работы с API библиотек, миграций, framework-specific паттернов и отладки незнакомых интеграций.
2. Playwright MCP
- Назначение: автоматизация браузера, проверка UI, скриншоты, инспекция DOM, диагностика консоли и e2e-валидация.
- Почему это важно: один из самых полезных MCP для storefront-флоу, checkout, auth, admin panel, фильтров и regression testing.
- Лучше всего подходит для: frontend-разработки, acceptance testing, визуальных проверок и воспроизведения browser-багов.
3. PostgreSQL MCP
- Назначение: смотреть схему, выполнять запросы, проверять миграции, валидировать данные и разбирать persistence-проблемы.
- Почему это важно: критически полезен для FastAPI backend в ecommerce, где есть каталог, заказы, пользователи, права и миграции.
- Лучше всего подходит для: backend-разработки, отладки данных, ревью миграций и ручной проверки business rules.
4. Docker или Compose MCP
- Назначение: управлять сервисами, смотреть логи, поднимать и останавливать стек, валидировать локальную containerized-среду.
- Почему это важно: особенно полезен, если backend, frontend, db, redis, search или storage запускаются через Compose.
- Лучше всего подходит для: локальной orchestration, просмотра логов сервисов, воспроизводимых сред и integration debugging.
5. GitLab MCP или GitHub MCP
- Назначение: работать с merge request или pull request, issues, CI pipelines, метаданными репозитория, review и automation context.
- Почему это важно: замыкает цикл между кодом, review и CI.
- Лучше всего подходит для: командной разработки, review cycle, issue-driven delivery и видимости пайплайнов.
- Рекомендация: если проект живет в GitLab, приоритет у GitLab MCP; иначе GitHub MCP.
Приоритет 2: очень полезно для ecommerce-проектов
6. Redis MCP
- Назначение: смотреть cache, sessions, queues, rate limits, pubsub и временное состояние.
- Почему это важно: полезен, если корзины, сессии, async jobs, search cache или throttling используют Redis.
- Лучше всего подходит для: отладки cache invalidation, auth sessions, task queues и временного commerce-state.
7. S3 или MinIO MCP
- Назначение: смотреть buckets, uploads, media assets, exports и generated files.
- Почему это важно: в ecommerce почти всегда есть product images, баннеры, документы, import и export.
- Лучше всего подходит для: asset handling, media debugging и проверки storage workflows.
8. Browser или DevTools MCP
- Назначение: смотреть network, frontend console, performance, hydration issues, layout bugs и rendering diagnostics.
- Почему это важно: хорошо дополняет Playwright, когда нужен более низкоуровневый browser debugging.
- Лучше всего подходит для: performance, network failures, client exceptions и сложных rendering-проблем.
9. Sentry MCP
- Назначение: смотреть production errors, stack traces, release regressions и alert context.
- Почему это важно: особенно полезен после деплоя или на проекте, где уже есть реальные пользователи.
- Лучше всего подходит для: post-release debugging, bug triage и поиска реальных high-impact проблем.
Приоритет 3: добавлять только по необходимости
10. OpenAPI или API testing MCP
- Назначение: валидировать REST-контракты, гонять API-сценарии, смотреть схемы и проверять integration flows.
- Почему это важно: полезен, если в проекте важна API-first валидация или команда опирается на contract testing.
- Лучше всего подходит для: backend QA, API verification, smoke tests и integration debugging.
11. Stripe MCP
- Назначение: смотреть оплаты, checkout sessions, webhooks, customers и billing flows.
- Почему это важно: нужен только если проект реально использует Stripe.
- Лучше всего подходит для: отладки платежей и проверки webhook flows.
12. Kubernetes MCP
- Назначение: смотреть workloads, логи, config, namespaces и deploy state.
- Почему это важно: полезен только если команда реально деплоит или дебажит через Kubernetes.
- Лучше всего подходит для: staging и production operations.
Рекомендуемый базовый набор для этого стека
Если нужен сильный и практичный базовый набор, сначала стоит добавить:
- Context7 или docs MCP
- Playwright MCP
- PostgreSQL MCP
- Docker или Compose MCP
- GitLab MCP или GitHub MCP
- Redis MCP, если стек использует cache или queues
- S3 или MinIO MCP, если стек использует media storage
Правило выбора
- Добавляй те MCP, которые закрывают реальные пробелы в разработке, тестировании, отладке, review и эксплуатации.
- Не перегружай конфиг узкоспециализированными MCP, которые проекту не нужны.
- В приоритете инструменты, которые ускоряют цикл работы сразу по backend, frontend, тестам, CI и production debugging.