Как работать с MCP

Сервер работает по stdio и предоставляет агенту доступ к документации, свойствам компонентов, примерам и гайдам по plasma-giga.

Быстрый старт​

Если ваш агент умеет подключать MCP-серверы по stdio, достаточно указать команду:

npx -y @salutejs/sdds-mcp@latest --lib plasma-giga --version latest

Если нужна актуальная версия документации, параметр --version можно не указывать:

npx -y @salutejs/sdds-mcp@latest --lib plasma-giga

Для plasma-giga поддерживаются версии, начиная с 0.338.0. Если запрошенная версия не найдена, сервер автоматически переключится на latest.

Если в настройках агент просит передать command и args отдельно, используйте такой шаблон:

{
  "mcpServers": {
    "plasma-giga": {
      "command": "npx",
      "args": [
        "-y",
        "@salutejs/sdds-mcp@latest",
        "--lib",
        "plasma-giga",
        "--version",
        "latest"
      ]
    }
  }
}

Какие инструменты доступны агенту​

После подключения MCP-сервер отдаст агенту следующие инструменты:

  • list_components - список доступных компонентов.
  • get_installation_guide - гайд по установке и подключению темы и токенов.
  • get_nextjs_guide - рекомендации по работе с библиотекой в Next.js.
  • get_functions - описание hooks, hocs, mixins и utils.
  • get_design_system_configuration - документация по конфигурации дизайн-системы.
  • get_form_guide - работа с формами и интеграция с form-решениями.
  • get_tokens - список токенов для повторного использования.
  • get_component - полная информация по компоненту.
  • get_component_props - пропсы и конфигурация конкретного компонента.
  • get_component_examples - примеры использования компонента.

Что можно спрашивать у агента​

После подключения MCP-сервера агенту можно задавать запросы в таком формате:

  • Покажи, как подключить plasma-giga в Next.js
  • Какие props есть у Button в plasma-giga?
  • Приведи примеры использования TextField
  • Какие компоненты есть в plasma-giga?
  • Покажи токены, которые можно использовать в кастомном компоненте