@brojs/mcp

MCP (Model Context Protocol) сервер для AI агентов с документацией по платформе BroJS.

Описание

Этот MCP сервер предоставляет AI агентам (Cursor, Claude Desktop, Kilo и др.) доступ к документации и справочной информации о платформе BroJS для создания микрофронтенд приложений.

Установка

npm install -g @brojs/mcp

Или использовать через npx:

npx @brojs/mcp

Использование

Запуск

# Базовый запуск
npx @brojs/mcp

Сервер не требует дополнительной конфигурации и работает сразу после установки.

Доступные инструменты (Tools)

brojs_overview

Краткое описание платформы BroJS, основные пакеты и типичный workflow.

Параметры: нет

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

"Расскажи о платформе BroJS"

brojs_config_explain

Детальное объяснение структуры bro.config.js и всех его секций.

Параметры:

• section (string, опциональный) - Конкретная секция для объяснения:
  • apiPath - Путь к заглушкам API
  • webpackConfig - Расширение webpack конфигурации
  • navigations - Навигационные маршруты
  • features - Feature-флаги
  • config - Конфигурационные ключи
  • htmlTemplatePath - Путь к HTML шаблону для prom-режима

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

"Объясни структуру bro.config.js"
"Расскажи про features в bro.config.js"

brojs_webpack_extend_examples

Готовые примеры расширения webpack конфигурации через bro.config.js.

Параметры: нет

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

"Покажи примеры расширения webpack для Tailwind CSS"
"Как добавить postcss-loader в bro.config.js?"

brojs_microfrontend_entry

Объяснение структуры точки входа микрофронтенда (src/index.tsx).

Параметры: нет

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

"Как должна выглядеть точка входа микрофронтенда?"
"Объясни mount и unmount функции"

Интеграция с AI ассистентами

Cursor

Добавьте в настройки Cursor (.cursor/mcp.json или через настройки):

{
  "mcpServers": {
    "brojs": {
      "command": "npx",
      "args": ["@brojs/mcp"]
    }
  }
}

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "brojs": {
      "command": "npx",
      "args": ["@brojs/mcp"]
    }
  }
}

Kilo

Добавьте в настройки Kilo:

{
  "mcpServers": {
    "brojs": {
      "command": "npx",
      "args": ["@brojs/mcp"]
    }
  }
}

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

Пример 1: Получение общей информации

После подключения MCP сервера к вашему AI ассистенту, вы можете спросить:

"Расскажи о платформе BroJS"

AI агент вызовет инструмент brojs_overview и предоставит краткую информацию о платформе.

Пример 2: Объяснение конфигурации

"Объясни структуру bro.config.js"

AI агент вызовет brojs_config_explain и детально объяснит все секции конфигурационного файла.

Пример 3: Примеры расширения webpack

"Покажи примеры добавления Tailwind CSS в bro.config.js"

AI агент вызовет brojs_webpack_extend_examples и предоставит готовые примеры кода.

Что такое BroJS?

BroJS — это платформа для создания микрофронтенд приложений с React и TypeScript. Основные возможности:

• Быстрая инициализация - npm init brojs для создания нового проекта
• Гибкая конфигурация - bro.config.js для настройки webpack, навигации, feature-флагов
• Dev-сервер - HMR, заглушки API, автоматическое открытие браузера
• Prom-режим - SPA-сборка и сервер для production-подобного запуска
• Микрофронтенд архитектура - интеграция с платформой через mount/unmount

Зависимости

• @modelcontextprotocol/sdk - MCP SDK

Лицензия

ISC

Ссылки

• Model Context Protocol
• Документация BroJS