@vargov/mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@vargov/mcp Find a light composition for a 6×4 m living room and give me the configurator link"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@vargov/mcp — Vargov®Design для ИИ-ассистентов / for AI assistants
MCP-сервер (Model Context Protocol), который даёт ассистенту в Claude Desktop, Cursor и любом другом клиенте MCP каталог Vargov®Design, ссылки в 3D-конфигуратор с размерами помещения и пошаговую инструкцию, как получить IFC4 (BIM) и FBX. Все данные лежат в пакете; в работе сервер в сеть не ходит.
An MCP (Model Context Protocol) server that gives an assistant in Claude Desktop, Cursor or any other MCP client the Vargov®Design catalogue, links into the 3D configurator with the room dimensions filled in, and the step-by-step way to get IFC4 (BIM) and FBX files. All data is bundled; the server makes no network calls at runtime.
Пример / example:
«Подбери световую композицию для гостиной 6 × 4 м с потолком 3,2 м и дай ссылку в конфигуратор» →
search_compositions→get_composition→build_configurator_link({ code, lengthMm: 6000, widthMm: 4000, ceilingMm: 3200 })→how_to_get_bim.
Русский
Что умеет
Инструмент | Что делает |
| Поиск по 605 композициям (коды LC0001…LC0602): по коду, по типу и по авторским текстам бренда (описание, где уместна, стилистика) на русском и английском; другие языки сайта тоже ищутся. Фильтры: |
| Карточка композиции по коду ( |
| Ссылка в конфигуратор по договору ключей: |
| Пошагово: шаг «3D схема композиции» → ящик «Документы» → «Скачать IFC (BIM)» / «Скачать FBX (3ds Max)»; что лежит в IFC4 (IfcLightFixture / IfcFurnishingElement, точки крепления отдельными объектами IfcDiscreteAccessory с числом элементов и — когда масса известна — нагрузкой, GUID от конфигурации; чего в IFC4 нет: тросов, каркаса, контуров подсветки) и в FBX (объекты в мм, нити телами, одно крепление на отверстие в потолке, без текстур и UV, без свойств BIM); когда открывается схема 1:1 (после запуска ТЗ в производство; 345 из 360). С кодом — ответ начинается со статуса этой композиции. Текст на английском или русском ( |
| Карточка бренда: основатель и год, каталог и семейства, круг конфигуратора (360 с расчётом, 345 со схемой 1:1), 26 достижений на международных премиях (число и список считаются из |
| Кто поставляет, монтирует и обслуживает композиции в стране: официальный дилер региона (Москва — Россия и СНГ; Ханой — Вьетнам, Лаос, Камбоджа, Таиланд, Малайзия, Сингапур; Дубай — Персидский залив, Ближний Восток, Америка, Европа, Азия, Африка и все остальные страны), страница с контактами дилеров, прямые контакты бренда, условия монтажа как на сайте. Страна — названием по-русски или по-английски, кодом ISO или крупным городом. Контакты дилеров в пакет не вшиты — они только на странице сайта. |
Ресурсы MCP: llms://vargov — en/llms.txt базы знаний; llms://vargov/ru — русский llms.txt;
llms://vargov/configurator — llms.txt конфигуратора.
Чего сервер не делает и не обещает: не называет цены, материалы и размеры композиций (бренд их не публикует — каждая композиция рассчитывается под помещение), не оформляет заказы и заявки, не считает раскладку сам (это делает конфигуратор по ссылке), не ходит в сеть.
Откуда данные
data/ — копии открытых файлов (лицензия CC BY 4.0, см. DATA-LICENSE.md): datasets/products.json
и references/*.json базы знаний vargov3-spec/vargov-ai-kb,
open-skus.json и llms.txt конфигуратора (они же отдаются на https://vargov.design/open-skus.json и
https://vargov.design/llms.txt). В data/manifest.json — дата сборки и sha256 каждого файла. Каталог
меняется — новые версии пакета выходят вместе с обновлением базы знаний; первичен сайт https://vargov.ru.
Числа в ответах (605, 360, 345, 26, 354/113/82/56, 310) не вписаны руками — они считаются из этих файлов и проверяются тестом перед каждой публикацией.
Как подключить
Нужен Node.js 20+. Ставить отдельно ничего не надо — клиент сам запустит пакет через npx.
Claude Desktop — claude_desktop_config.json
(Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"vargov-design": { "command": "npx", "args": ["-y", "@vargov/mcp"] }
}
}Cursor — .cursor/mcp.json в проекте или ~/.cursor/mcp.json глобально, тот же блок mcpServers.
Claude Code — одной командой: claude mcp add vargov-design -- npx -y @vargov/mcp.
После подключения спросите ассистента, например: «Найди у Vargov®Design световую композицию для лобби с потолком 6 м и дай ссылку в конфигуратор».
Related MCP server: @dsk/mcp
English
What it does
Tool | Purpose |
| Search over the 605 compositions (codes LC0001…LC0602) by code, type label and the brand's own texts (description, where it works, style) in Russian and English; other site languages are matched too. Filters: |
| The card of one composition by code ( |
| A configurator link by the link-keys contract: |
| Step by step: the "3D composition scheme" step → the "Documents" drawer → "Download IFC (BIM)" / "Download FBX (3ds Max)"; what the IFC4 holds (IfcLightFixture / IfcFurnishingElement, fixing points as separate IfcDiscreteAccessory objects with element count and, where the mass is known, load, GUIDs derived from the configuration; not in IFC4: cables, frame, backlight contours) and what the FBX holds (objects in mm, strands as bodies, one fixing per ceiling hole, no textures or UVs, no BIM properties); when the 1:1 drawing opens (after the production brief is started in production; 345 of 360). With a code, the answer starts with that composition's status. English or Russian ( |
| The brand card: founder and year, catalogue and families, configurator scope (360 with a full calculation, 345 with the 1:1 drawing), 26 awards from international juries (count and list computed from |
| Who supplies, installs and services the compositions in a country: the regional official dealer (Moscow — Russia and the CIS; Hanoi — Vietnam, Laos, Cambodia, Thailand, Malaysia, Singapore; Dubai — the Persian Gulf, Middle East, Americas, Europe, Asia, Africa and every other country), the page with the dealer contacts, the brand's direct contacts, the installation terms as published. Country by English or Russian name, ISO code or a major city. Dealer contacts are not bundled — they live on the site page only. |
MCP resources: llms://vargov — the knowledge base's en/llms.txt; llms://vargov/ru — the Russian
llms.txt; llms://vargov/configurator — the configurator's llms.txt.
What the server does not do or promise: it names no prices, materials or composition dimensions (the brand does not publish them — every composition is scaled to the room), it places no orders or requests, it does not compute the layout itself (the configurator does, through the link), and it never calls the network.
Where the data comes from
data/ holds copies of public files (CC BY 4.0, see DATA-LICENSE.md): datasets/products.json and
references/*.json of the knowledge base vargov3-spec/vargov-ai-kb,
and the configurator's open-skus.json and llms.txt (also served at https://vargov.design/open-skus.json
and https://vargov.design/llms.txt). data/manifest.json records the build date and the sha256 of every
file. The catalogue changes, so new package versions follow knowledge-base updates; the site
https://vargov.ru is the primary source.
The numbers in the answers (605, 360, 345, 26, 354/113/82/56, 310) are not typed in: they are computed from these files and checked by the test before every release.
Install and connect
Node.js 20+ required. Nothing to install by hand — the client starts the package through npx.
Claude Desktop — claude_desktop_config.json
(Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"vargov-design": { "command": "npx", "args": ["-y", "@vargov/mcp"] }
}
}Cursor — .cursor/mcp.json in the project or ~/.cursor/mcp.json globally, the same mcpServers block.
Claude Code — one command: claude mcp add vargov-design -- npx -y @vargov/mcp.
Then ask the assistant, for example: "Find a Vargov®Design light composition for a lobby with a 6 m ceiling and give me the configurator link."
Licence
Code — MIT (LICENSE). Data in data/ — CC BY 4.0, attribution "Vargov®Design", https://vargov.ru
(DATA-LICENSE.md).
Available Tools
6 toolsbrand_factsBrand cardARead-onlyIdempotent
Compact card of Vargov®Design: founder and founding year, catalogue size and families, configurator scope (full calculation, 1:1 drawing), the awards count and list, certification, trademarks, showroom, contacts, dealers page, site languages, links to llms.txt of the site, the knowledge base and the configurator, the open dataset on Hugging Face. Numbers are computed from the bundled data.
Inputs: lang.
build_configurator_linkConfigurator link with room dimensionsARead-onlyIdempotent
Builds a link that opens the Vargov®Design 3D configurator on a composition with the plan dimensions and the room ceiling height already filled in. Only codes that open with a full calculation are accepted (360 of 605; others return an error with the product page). lengthMm → the "Length" field of the plan, widthMm → the "Width" field, both integer millimetres, at least 300 (the plan is the zone the composition is laid out in, not a product size); heightMm → height of the cloud of elements (optional); ceilingMm → room ceiling height (optional, default 2700 in the configurator; it goes into the IFC4 file and AR); lang → interface language (ru opens configurator.vargov.ru, other languages vargov.design); openOnFormStep → open scrolled to the "Composition form" step. The visitor then picks element sizes, colours and the form; the configurator's "Share" button returns a link that reopens that exact calculation.
Inputs: code (required), lang, widthMm, heightMm, +3 more.
dealer_for_countryOfficial dealer for a countryARead-onlyIdempotent
Who supplies, installs and services Vargov®Design compositions in a given country: the official dealer of that region (Moscow — Russia and the CIS; Hanoi — Vietnam, Laos, Cambodia, Thailand, Malaysia, Singapore; Dubai — the Persian Gulf, Middle East, Americas, Europe, Asia, Africa and every other country), the page with the dealer contacts, the brand's direct contacts, and the installation terms as published (a separate service priced individually; supervised installation available). country: a country name in English or Russian, an ISO 3166 alpha-2 code, or a major city (Dubai, Moscow, Hanoi…). Without country, returns all three regions.
Inputs: lang, country.
get_compositionComposition cardARead-onlyIdempotent
Everything the public dataset knows about one composition by its code (LC0564, lc0564, "564" are all accepted): names RU/EN, family and type, the brand's texts in the requested language (default en; ru de it fr es vi ar available), site pages in 8 languages, cover image, 3D models (3ddd/3dsky, Sketchfab), awards, whether it is certified (fact only), and the configurator status: opens with a full calculation or is calculated individually; kind (cloud of elements / ribbon / chain / on a frame / ready scene); IFC4, FBX, PDF and tender-sheet exports; whether the 1:1 ceiling drawing exists; ready links. For compositions of the ceramic collection, ceramic_collection gives the group and the page. No price and no composition dimensions — they are not published.
Inputs: code (required), lang.
how_to_get_bimHow to get IFC4 (BIM) and FBXARead-onlyIdempotent
Step-by-step: where the "Download IFC (BIM)" and "Download FBX (3ds Max)" buttons are (step "3D composition scheme" → "Documents" drawer), what the IFC4 and FBX files contain and what they do not (no textures/UV, BIM properties only in IFC4, ceiling fixing points as IfcDiscreteAccessory objects), and when the 1:1 ceiling drawing opens (only after the production brief is started in production). With a code, the answer starts with the status of that composition (full calculation / calculated individually; ribbon, chain, frame, ready scene). Text in English or Russian.
Inputs: code, lang.
search_compositionsSearch Vargov®Design compositionsARead-onlyIdempotent
Search the Vargov®Design catalogue: 605 made-to-order light and decorative compositions, codes LC0001…LC0602. Full-text over codes, type labels and the brand's own texts (description, where it works, style) in Russian and English; other site languages are matched too. Filters: family (lighting | decorative | sculptural-decor | floor-table-lamps); lit (true = the lighting family or a type label mentioning light/lamp/backlit — a hint derived from labels, not a measured property); awarded (has a listed award); configurable (opens in the 3D configurator with a full calculation: IFC4, FBX, PDF specification, tender sheet — 360 of 605); material: "ceramic" — the ceramic collection published at vargov.ru/en/ceramics (ceramic elements, ceramic with glass or crystal, ceramic or opaque white glass to choose; from the brand's own material marking). Returns compact rows: code, names RU/EN, family, type, flags, site pages, cover image, English snippet. Then use get_composition for details and build_configurator_link to open the configurator with the room plan. No prices or composition dimensions are published.
Inputs: lit, limit, query, family, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct role: catalogue search, single-record lookup, configurator link generation, BIM/download guidance, brand facts, and dealer lookup. The only soft overlap is that how_to_get_bim with a code echoes configurator/calculation status that get_composition already returns, and brand_facts partially restates awards/catalogue size also surfaced in search rows.
Three tools follow a clean verb_noun pattern (search_compositions, get_composition, build_configurator_link), but brand_facts and dealer_for_country are bare noun phrases and how_to_get_bim is an interrogative-style name. Mixing action-oriented and information/noun naming across the set makes the convention only partially predictable.
Six tools is well-scoped for a read-only catalogue/brand-information server, with no filler entries. Each tool covers a distinct facet (search, detail, configurator, BIM, brand, dealers) rather than duplicating functionality.
Coverage of the public domain is strong: discovery via search, full record retrieval, configurator deep-linking, BIM/export guidance, brand card, and regional dealer resolution. Minor gaps exist—no explicit way to enumerate filter vocabularies (families, types, awards) or batch-compare several codes without repeated get_composition calls.
Maintenance
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA powerful MCP server that enables AI assistants to discover, commission, and control Matter-compatible smart home devices through a standardized interface.20 npm9MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI assistants structured access to a design system's tokens, components, guidelines, and patterns, enabling them to read, lint, and author design system data.1MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI shopping assistants to understand customer needs, search products using visual and semantic queries, apply metadata filters, and recommend relevant products from an inventory.2Apache 2.0
- AlicenseAqualityDmaintenanceMCP server for Speckle that enables AI-powered AEC interoperability, letting users manage Speckle projects, models, and versions through natural language, with guidance for data push/pull via native connectors.8MIT