hoklims/stacksfinder-mcp

Analyze Repository MCPs

Анализирует ваш текущий репозиторий для определения технологического стека и рекомендует подходящие MCP серверы. Этот инструмент проверяет файлы вашего проекта (package.json, .env, конфигурационные файлы и т.д.), чтобы: 1. Выявить технологии фронтенда, бэкенда, базы данных, аутентификации, хостинга и платежей 2. Найти уже установленные MCP серверы 3. Порекомендовать новые MCP, которые улучшат ваш процесс разработки 4. Сгенерировать готовые конфигурации для установки в Cursor, Claude Desktop и Windsurf Примеры использования: - «Какие MCP помогут моему проекту?» - «Проанализируй мой репозиторий и предложи полезные MCP серверы» - «Каких MCP мне не хватает исходя из моего стека технологий?»

Analyze Technology

Детальный анализ технологии: оценки по 6 измерениям, сильные и слабые стороны, совместимые технологии. **Предварительные требования**: сначала используйте `list_technologies`, чтобы узнать допустимые идентификаторы технологий. **Дальнейшие шаги**: - Сравнить с альтернативами: `compare_techs({ technologies: ["tech1", "tech2"] })` - Получить рекомендацию по полному стеку: `recommend_stack_demo({ projectType: "saas" })` **Оценка по измерениям**: Опыт разработчика, Производительность, Масштабируемость, Безопасность, Экосистема, Стоимость **Частые ошибки**: - Неизвестный ID технологии: используйте точные ID из list_technologies (например, "nextjs", а не "Next.js") **Пример**: `analyze_tech({ technology: "nextjs", context: "mvp" })`

Check MCP Compatibility

Проверяет совместимость между MCP-серверами. Обнаруживает конфликты (например, два провайдера баз данных), избыточности (например, две ORM) и синергии (например, GitHub + Vercel). Возвращает оценку здоровья (0-100) с грейдом (A/B/C/D) и подробной расшифровкой. **Примеры:** - Проверка совместимости баз данных: `["supabase-mcp", "neon-mcp"]` → обнаружен конфликт - Проверка избыточности ORM: `["prisma-mcp", "drizzle-mcp"]` → предупреждение об избыточности - Проверка синергии: `["stripe-mcp", "resend-mcp"]` → обнаружена синергия **Поддерживаемые MCP ID включают:** - supabase-mcp - neon-mcp - planetscale-mcp - turso-mcp - prisma-mcp - drizzle-mcp - clerk-mcp - auth0-mcp - stripe-mcp - paddle-mcp ...и другие. **Поддерживаются алиасы:** - "supabase" → "supabase-mcp" - "@neondatabase/mcp" → "neon-mcp" - "stripe" → "stripe-mcp"

Compare Audit Reports

Сравнивает два аудиторских отчёта, чтобы отслеживать динамику технического долга. Показывает новые внесённые проблемы, решённые проблемы и изменение показателя здоровья. Полезно для измерения прогресса в сокращении долга.

Compare Technologies

Сравнение 2-4 технологий бок о бок с указанием победителей по каждому измерению и матрицей совместимости. **Предварительные требования**: сначала вызовите `list_technologies`, чтобы найти допустимые идентификаторы технологий. **Дальнейшие шаги**: - Детальный анализ победителя: `analyze_tech({ technology: "winner-id" })` - Получить полный стек: `recommend_stack_demo({ projectType: "saas" })` **Результат включает**: - Таблица сравнения баллов - Победители по каждому измерению - Совместимость между сравниваемыми технологиями - Общая рекомендация **Типичные ошибки**: - Нужно указать от 2 до 4 технологий (не 1, не 5+) - Используйте точные ID из `list_technologies` **Пример**: `compare_techs({ technologies: ["nextjs", "sveltekit", "remix"], context: "mvp" })`

Create API Key

Создаёт новый API-ключ с использованием аутентификации OAuth (предпочтительно для пользователей ChatGPT). **Уровень**: Требуется подписка Pro или Team **Предварительные требования**: Аутентификация через OAuth (ChatGPT Actions обрабатывает это автоматически) **Дальнейшие шаги**: - Проверьте, что ключ создан: `list_api_keys()` - Используйте функции Pro: `recommend_stack()`, `create_audit()`, `create_blueprint()` **Почему использовать это вместо setup_api_key**: - Не требует email/пароль - Безупречно работает с интеграцией ChatGPT OAuth - Предпочтительный метод для пользователей ChatGPT **Частые ошибки**: - Ключ показывается только один раз - сохраните его надёжно **Пример**: `create_api_key({ keyName: "my-chatgpt-key" })`

Create Technical Debt Audit

Создаёт аудит технического долга для вашего стека технологий. Анализирует устаревшие пакеты, уязвимости безопасности, версии на грани завершения поддержки (EOL) и рекомендации по обновлению. **Уровень доступа**: требуется подписка Pro или Team (либо OAuth-сессия) **Предварительные требования**: - Аккаунт Pro/Team или авторизация через OAuth - Список технологий с версиями (используйте данные package.json) **Дальнейшие шаги**: - Получить полный отчёт: `get_audit({ auditId: "returned-uuid" })` - Получить план миграции: `get_migration_recommendation({ auditId: "uuid" })` - Сравнить аудиты по времени: `compare_audits({ baseAuditId, compareAuditId })` **Выходные данные включают**: - Оценка здоровья (0–100) - Находки по критичности (critical/high/medium/low/info) - Действенные рекомендации по обновлению - Обнаружение CVE для известных уязвимостей **Типичные ошибки**: - Указывайте номера версий для точного обнаружения уязвимостей - Используйте названия технологий так, как они указаны в менеджерах пакетов **Пример**: `create_audit({ name: "Q1 2026 Stack Review", technologies: [{ name: "React", version: "17.0.0" }, { name: "Node.js", version: "14.0.0" }] })`

Create Blueprint

Создаёт новый блюпринт технологического стека для проекта. Генерация блюпринта асинхронна. По умолчанию этот инструмент дожидается завершения и возвращает полный блюпринт. Установите waitForCompletion=false, чтобы сразу получить ID задачи для ручного опроса. Примеры использования: - Создать SaaS MVP: projectType="saas", scale="mvp", priorities=["time-to-market", "cost-efficiency"] - Создать enterprise API: projectType="api", scale="enterprise", priorities=["security", "scalability"]

Estimate Project

Оценивает объём работ, ценообразование и проводит анализ рынка для программного проекта. Что даёт: - Детальная разбивка часов по фичам (с оценкой сложности) - Диапазоны цен по уровню команды (junior/mid/senior/expert) - Анализ конкурентов и рыночные тренды (в реальном времени через Perplexity) - Размер рынка и выявление пробелов - Выявление рисков с предложениями по их снижению Отлично подходит фрилансерам и агентствам, составляющим сметы. **Ценообразование детерминировано на 100%** — одинаковые входные данные всегда дают одинаковый результат. Анализ рынка выполняется по принципу best-effort и может меняться при изменении веб-данных.

Execute MCP Installation

Читает конфигурационный файл .env-mcp и создаёт команды установки для MCP. Этот инструмент: 1. Читает файл .env-mcp, созданный prepare_mcp_installation 2. Проверяет, что все необходимые переменные окружения присутствуют 3. Генерирует команды установки для целевой IDE/клиента 4. Возвращает инструкции после установки Предварительные требования: - Сначала запустите prepare_mcp_installation, чтобы сгенерировать .env-mcp - Заполните необходимые ключи API и учётные данные в .env-mcp - Установите INSTALL_xxx=false для MCP, которые хотите пропустить Поддерживаемые цели: - claude-code: создаёт команды 'claude mcp add-json' - claude-desktop: создаёт JSON-конфиг для claude_desktop_config.json - cursor: создаёт JSON-конфиг для настроек MCP в Cursor - vscode: создаёт JSON-конфиг для расширения MCP в VS Code - windsurf: создаёт JSON-конфиг для Windsurf Вывод: - Отдельные команды/конфиги для каждого готового MCP - Общая команда (для Claude Code) или конфиг (для остальных) - Список MCP, у которых не хватает обязательных учётных данных - Инструкции после установки

Generate MCP Kit

Сгенерируйте полный комплект проекта с оптимальным стеком технологий и рекомендациями MCP на основе вашего описания. Опишите свой проект и получите: 1. **Оптимальный стек технологий**: лучшие технологии для каждой категории (фронтенд, бэкенд, база данных, аутентификация, хостинг, платежи) 2. **Рекомендации MCP**: инструменты AI-ассистентов под ваш выбор технологий 3. **Конфиги для установки**: готовые к использованию конфиги для Claude Desktop, Cursor и Windsurf Примеры запросов: - «Собираю SaaS для управления проектами с совместной работой в реальном времени» - «Делаю MVP маркетплейса для связи фрилансеров с клиентами» - «Создаю e-commerce платформу с платежами через Stripe и PostgreSQL»

Get Audit Report

Получить готовый аудиторский отчёт по ID. Возвращает все находки и оценку здоровья.

Get Audit Quota

Проверьте оставшуюся квоту аудита на этот месяц.

Get Blueprint

Получает существующий blueprint по ID. Blueprints создаются через веб-интерфейс StacksFinder или с помощью этого инструмента.

Get Estimate Quota

Проверьте свой остаток квоты оценки на эту неделю и месяц.

Get Migration Recommendation

Анализирует отчёт аудита в поиске возможностей для миграции. Возвращает подробную рекомендацию по миграции, включающую: - Технологии, которые следует заменить - Рекомендуемые современные альтернативы - Дорожную карту миграции с фазами - Оценку рисков - Ограничения Builder для предварительного заполнения при генерации плана миграции Используйте этот инструмент после create_audit, чтобы получить практические рекомендации по миграции.

Get Workflow Guide

Интеллектуальный гид по рабочим процессам, который подсказывает, какой инструмент использовать следующим, исходя из вашей цели и контекста. **Когда использовать**: - Вы не уверены, какой инструмент StacksFinder вызвать следующим - Вы хотите понять рекомендуемый workflow для вашей цели - Вам нужна помощь в разборе возможностей Pro и Free **Поддерживаемые цели**: - discover: Изучение доступных технологий - setup_api_key: Получение доступа к возможностям Pro - get_recommendation: Получить рекомендацию по стеку - audit_project: Аудит технического долга - migrate_stack: Получить рекомендации по миграции - install_mcp: Настройка MCP в вашей IDE - compare_techs: Сравнение технологий - create_blueprint: Создание и сохранение blueprint **Пример**: get_workflow_guide({ current_goal: "audit_project", user_tier: "free" })

Import Better-T-Stack Project

Импортируйте проект Better-T-Stack и создайте аудит. **Сценарий**: Если проект создан с помощью Better-T-Stack CLI, вы можете импортировать его напрямую для аудита технического долга. **Варианты ввода**: 1. GitHub URL — мы автоматически получим package.json 2. Содержимое package.json в сыром виде — вставьте содержимое файла напрямую **Что происходит**: - Определяются технологии по зависимостям - Вычисляется «BTS confidence score» (чем выше, тем вероятнее, что проект сделан с Better-T-Stack) - Автоматически создаётся и запускается аудит - Возвращаются результаты и оценка здоровья (health score) **Уровень доступа**: Требуется подписка Pro или Team (ИЛИ OAuth-сессия) **Пример (GitHub)**: ```json { "type": "github", "url": "https://github.com/username/my-bts-app", "name": "My BTS App Audit" } ``` **Пример (package.json)**: ```json { "type": "package-json", "content": "{"name": "my-app", "dependencies": {...}}" } ``` **Что делать после импорта**: - Получить план миграции: `get_migration_recommendation({ auditId: "uuid" })` - Сравнить с будущими аудитами: `compare_audits({ baseAuditId, compareAuditId })`

List API Keys

Выводит список ваших ключей API StacksFinder. Требует настроенный ключ API.

List Audit Reports

Выводит список отчетов аудита с пагинацией. Показывает название, статус, оценку здоровья и дату создания.

List Technologies

Выводит все доступные идентификаторы технологий, сгруппированные по категориям. Отличная отправная точка для поиска. **Предварительные требования**: Нет - это обычно первый вызываемый инструмент. **Следующие шаги**: - Проанализировать конкретную технологию: `analyze_tech({ technology: "nextjs" })` - Сравнить технологии: `compare_techs({ technologies: ["nextjs", "sveltekit"] })` - Получить рекомендацию стека: `recommend_stack_demo({ projectType: "saas" })` **Категории**: frontend, backend, meta-framework, database, orm, auth, hosting, payments, cms **Пример**: `list_technologies({ category: "frontend" })`

Prepare MCP Installation

Анализирует ваш репозиторий и генерирует конфигурационный файл .env-mcp для установки сервера MCP. Этот инструмент: 1. Определяет ваш технологический стек по файлам проекта (package.json, .env и т.д.) 2. Выявляет, какие MCP-серверы принесут пользу вашему проекту 3. Находит уже установленные MCP, чтобы избежать дублирования 4. Генерирует шаблон файла .env-mcp со всеми необходимыми переменными окружения Сгенерированный файл .env-mcp содержит: - Флаги INSTALL_xxx для управления тем, какие MCP устанавливать - Обязательные и опциональные переменные окружения для каждого MCP - Ссылки на документацию и примеры После запуска этого инструмента: 1. Откройте сгенерированный файл .env-mcp 2. Заполните API-ключи и значения конфигурации 3. Установите INSTALL_xxx=false для MCP, которые вам не нужны 4. Запустите execute_mcp_installation, чтобы завершить настройку Примеры использования: - "Подготовить установку MCP для моего проекта" - "Сгенерировать .env-mcp для моего технологического стека" - "Какие MCP мне нужны и какие учетные данные требуются?"

Recommend Stack

Рекомендует лучший стек технологий для проекта, используя скоринг в реальном времени с контекстными корректировками.

Recommend Stack (Demo)

Быстрая рекомендация технологического стека на основе типа и масштаба проекта. **Предварительные требования**: Нет — отличная отправная точка для новых пользователей. **Следующие шаги**: - Проанализировать конкретную технологию: `analyze_tech({ technology: "recommended-id" })` - Полная рекомендация с приоритетами: `recommend_stack()` **Результат включает**: - Оптимальную технологию для каждой категории (фронтенд, бэкенд, база данных и т.д.) - Оценку и уровень для каждой рекомендации - Основано на 100% детерминированной оценке (без галлюцинаций ИИ) **Пример**: `recommend_stack_demo({ projectType: "saas", scale: "mvp" })`

Revoke API Key

Отзывает API-ключ. Это действие нельзя отменить.

Setup API Key

Выполняет аутентификацию в вашем аккаунте StacksFinder и создаёт API-ключ с помощью email/пароля. **Дальнейшие шаги**: - Проверьте создание ключа: `list_api_keys()` - Используйте функции Pro: `recommend_stack()`, `create_audit()`, `create_blueprint()` **Частые ошибки**: - Для пользователей ChatGPT OAuth: используйте `create_api_key()` (email/пароль не нужны) - Если используете ChatGPT с OAuth, возможно, потребуется передать фиктивные значения email/пароля **Пример**: `setup_api_key({ email: "you@example.com", password: "your-password", keyName: "my-key" })`