archviz_mcp
A read-only MCP server for live OfficeNext architectural reference lookup and in-memory gallery image viewing; the schema exposes a narrower OfficeNext-only subset than the README describes.
Report supported live sources and storage behavior without fetching or crawling.
Search OfficeNext live using 1–4 Russian keywords or a project name; returns candidate project links, not verified design matches.
Read an OfficeNext project for authors, stated dates/materials, focused text excerpts, and all gallery image URLs.
View one gallery photo from a verified OfficeNext project in memory, up to 1600 px, without creating a local image file; attribution should be preserved.
Tools are read-only, idempotent, non-destructive, and do not maintain a database, search index, or image archive.
It does not download images during reading or infer hidden construction, dimensions, cost, or acoustic performance from photos.
The provided schema does not expose the README's multi-source adapters, catalog browsing, or visualization-series workflow/check tools.
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., "@archviz_mcp Find acoustic ceiling references for a high atrium and show photos."
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.
archviz_mcp
Живые архитектурные референсы, пробный кадр и проверяемая серия визуализаций по BIM.
Находит проекты онлайн, читает описание и авторство, показывает выбранные фотографии. Не создаёт локальную базу проектов, архив изображений или поисковый индекс. Подключены OfficeNext, ArchDaily, FRAME, Architizer и WAF — с разными возможностями поиска и чтения, указанными ниже. API-ключи не нужны.
English: a read-only stdio MCP server for live architectural references and stateless visualization review, with a Russian-language skill. Adapters cover OfficeNext, ArchDaily public projects, FRAME public projects, Architizer Journal/A+Awards and WAF winner panels. Search capabilities vary; discovery-only fallbacks are explicit. No renderer, automatic image-quality scorer, persistent project database or image archive.
Что внутри
Инструмент | Результат |
| Поддерживаемые источники, ограничения поиска и хранения |
| Поиск по доступным источникам и явные подсказки для веб-поиска там, где нет серверного поиска |
| Фильтрация одного годового каталога Architizer или WAF; ID конкретных конкурсных карточек |
| Авторство, сведения источника, выдержки и ссылки на галерею |
| Одна фотография в ответе MCP, без создания файла |
| Контракт серии: роли источников, камеры, пробный кадр, раздельные проверки и JSON Schema паспорта |
| Проверка записей о принятии пилота, версиях входов, визуальных разборах и финальном отборе |
Скилл architectural-visualization связывает референсы, паспорт камеры, пробный кадр и проверку серии. Сам сервер не меняет BIM и не генерирует рендеры — для этого нужны инструменты хоста.
Related MCP server: Mimicus
Источники: версия 0.3
Источник | Что работает в MCP | Границы |
OfficeNext | Нативный поиск, карточки, авторство, галерея и просмотр фото | Короткие русские запросы; выдача не охватывает весь архив |
ArchDaily | Публичные карточки проектов, спецификации, галерея и просмотр изображений | Поиск через веб-инструмент хоста; статьи за подпиской не извлекаются |
FRAME | Публичные проекты: описание, бюро, фото, планы и подписи | Поиск через хост; только данные выбранного проекта, без профилей и соседних подборок |
Architizer | Поиск Journal, чтение статей; годовые каталоги A+Awards, отдельные конкурсные карточки и изображения | Journal — редакционные статьи, не карточки зданий. Полные |
WAF / Interiors | Каталог победителей 2025, авторство, категории и изображения конкурсных карточек | Картинка может быть конкурсным планшетом. World Buildings Directory не подключён |
Office Snapshots, Dezeen | Адреса источников и запросы для веб-поиска хоста | Прямой доступ заблокирован в проверке; серверных адаптеров нет |
Для Architizer можно запросить отдельный выпуск 2013–2026. Проверены 2013, 2018, 2020, 2024, 2025 и 2026; остальные годы не объявляются проверенными. Для WAF сейчас настроен только 2025. Год выпуска премии не равен году реализации.
source="all" возвращает результаты доступных поисков вперемешку и отдельный source_reports с ограничениями и ошибками. Подсказки host_search_required — ещё не выполненный поиск. Для совместимости значение source по умолчанию остаётся officenext; широкий поиск нужно запросить явно. Английские ключевые слова нужны для международных источников, автоматического перевода нет.
search_references(query="office ceiling", source="all", limit=8)
browse_reference_catalog(source="architizer", year=2024, query="office", limit=5)
# Из результата каталога переносим ОБА поля — url и entry_id:
read_reference(url=entry["url"], entry_id=entry["entry_id"], focus="ceiling")
view_reference_image(project_url=entry["url"], entry_id=entry["entry_id"], image_index=0)Это примеры аргументов инструментов, не отдельный Python-клиент. Выборки каталога используют offset/next_offset; Journal поддерживает только первую страницу. Текстовый фильтр каталога ищет все слова запроса в описании, названии, авторстве и категории. Это не семантическая оценка сходства интерьеров.
Серия визуализаций: версия 0.2
Фотографическая убедительность и соответствие проекту проверяются отдельно. Принятая палитра или успешный вызов генератора не означают принятый кадр. Для новой фотографической серии скилл сначала делает один пробный кадр и получает явную пользовательскую оценку конкретной версии; пользователь может явно отменить паузу, сохранив проверки качества.
Вызвать
visualization_workflow, зафиксировать паспорт проекта и роли источников.Получить пробный кадр инструментом хоста. Открыть картинку и источники, записать наблюдения по геометрии и подаче.
Добавить точную пользовательскую оценку с областью действия и SHA-256 изображения. Решения агента хранятся отдельно.
Проверить готовность через
check_visualization_series, расширить серию и проверить каждый отобранный ракурс, включая сравнение между видами.Сохранить в проекте финальный отбор и историю отклонений. Заменённые изображения/входы и изменённый целевой свет/материалы требуют свежей проверки.
При строгой геометрии контракт требует рендер общей сцены с зафиксированными версиями света, материалов и камер. Генеративный путь остаётся концептуальным. Наличие подходящего рендера агент проверяет отдельно; эта версия MCP его не добавляет.
Паспорт передаётся в вызов как JSON и сохраняется хостом в проекте пользователя, не в этом репозитории. Сервер не читает файлы и не сохраняет паспорт. Он проверяет предоставленные записи и хеши, но не видит пиксели, не вычисляет оценку фотореализма и не удостоверяет авторство цитат. Зелёная проверка не заменяет просмотр и решение пользователя. Подробности: контракт серии.
При доработке изучены внешние скиллы: управление камерой, проверка исходных экспортов, воспроизводимая сцена и сравнение ракурсов. Их код не устанавливался и не включён в пакет.
Быстрый запуск
Требуются Python 3.11+ и uv. Вариант из исходников даёт воспроизводимые зависимости из uv.lock:
git clone https://github.com/proovcme/archviz_mcp.git
cd archviz_mcp
uv sync --locked
uv run --locked archviz-mcpСервер ждёт MCP-сообщения в stdin/stdout, это не сайт и не интерактивная консоль. Завершение вручную — Ctrl+C. Диагностика идёт в stderr.
Для разового запуска без клонирования:
uvx --from git+https://github.com/proovcme/archviz_mcp.git archviz-mcpЭтот вариант устанавливает код и зависимости в кэш uv. Требование «без базы» относится к контенту референсов, а не к установленным программам. Для фиксированной версии к Git URL можно добавить @<commit-sha>.
Подключение к Codex
После клонирования замените /absolute/path/archviz_mcp на свой абсолютный путь:
codex mcp add architectural_references --env PYTHONUTF8=1 -- uv --directory /absolute/path/archviz_mcp run --locked archviz-mcpНа Windows путь с пробелами заключите в кавычки. Если uv не находится в окружении приложения, укажите полный путь к нему.
Для других MCP-клиентов используйте эквивалентную конфигурацию (имя верхнего поля зависит от клиента):
{
"mcpServers": {
"architectural_references": {
"command": "uv",
"args": ["--directory", "/absolute/path/archviz_mcp", "run", "--locked", "archviz-mcp"],
"env": {"PYTHONUTF8": "1"}
}
}
}Скопируйте папку skills/architectural-visualization в каталог навыков вашего агента. Для Codex это обычно ~/.codex/skills/ (либо каталог skills внутри настроенного CODEX_HOME). Не перезаписывайте свою изменённую версию без сравнения. Затем откройте новый чат и проверьте наличие семи инструментов. Уже работающий MCP-процесс после обновления нужно переподключить средствами хоста. Документация Codex MCP.
Как использовать
Пример задания агенту:
Используй $architectural-visualization. Найди примеры акустических потолков для высокого вестибюля. Нужны подвесные скруглённые острова, спокойный характер и выразительный свет. Посмотри фотографии, объясни, что применимо к нашей геометрии. Сохрани только выбранные ссылки и выводы.
Типичная последовательность:
Проверить
reference_sources.Выполнить короткие русские запросы в OfficeNext и английские с
source="all":acoustic,ceiling,lobby. Обработать подсказки веб-поиска хостом; выбрать подходящие годы и категории премий.Прочитать подходящие карточки; для
focusполезны корни «акуст», «потол», «освещ».Открыть релевантные фотографии через
view_reference_image.Разделить сведения автора, видимое на фото и предложенный перенос в новый проект.
Поисковая выдача не является готовой рекомендацией. Совпадение по слову «акустика» не доказывает наличие нужных потолочных панелей. Бюджет, высота, класс акустики и узлы крепления остаются неизвестными, если источник их не подтверждает.
Хранение, источники и ограничения
Никаких фоновых обходов каталога и массового скачивания. Сетевые запросы выполняются по вызову инструмента.
HTML-кэш только в оперативной памяти: до 16 страниц, срок повторного использования 180 секунд. Изображения не кэшируются сервером на диск, выбранное фото передаётся в память клиента с размером до 1600 px.
MCP-хост может сохранять ответы и изображения в истории чата. Сервер не управляет политикой хранения хоста.
Поиск и охват различаются по источникам: нативная выдача, фильтр одного каталога или явная передача поиска хосту. Ни один режим не обещает полный архив.
Веб-страницы могут менять разметку, выдачу и доступность. Ошибки возвращаются явно; при проблемах используйте браузер или поиск по домену источника.
Разрешены только конкретные HTTPS-домены, маршруты и CDN источников. Перенаправления между источниками отклоняются; размеры ответов ограничены, запросы разделены паузой. Произвольные URL и локальные адреса не поддерживаются.
Тексты источников считаются данными, а не инструкциями для агента.
Независимый проект, не официальный продукт перечисленных площадок. Фотографии и тексты принадлежат правообладателям; лицензия кода не даёт прав на их перепубликацию. Сохраняйте ссылки и авторство, учитывайте условия источника.
Проверка
uv run --locked python -m unittest -v test_server test_visualization test_sources
uv run --locked python test_server.py --live
uv run --locked python live_sources.py
uv buildОбычные тесты не обращаются к сети: проверяют парсинг, границы URL, этап принятия пользователем, раздельные проверки, устаревшие ревизии, отбор и согласованность сцены. Они также запускают реальный stdio MCP и проверяют контракт/приёмку на синтетическом паспорте. Live smoke test отдельно ищет три темы, читает карточки и проверяет передачу фото в памяти. Тесты не оценивают художественное качество. Межисточниковый тест live_sources.py проверяет чтение и декодирование изображения через настоящий stdio MCP для пяти площадок, включая Journal и конкурсные карточки. Live-тесты зависят от доступности сайтов и запускаются вручную; CI выполняет автономные тесты на Windows/Linux и Python 3.11/3.13.
Развитие
Проверка дополнительных источников: ArchDaily, Office Snapshots, WAF, FRAME, Architizer и Dezeen. В отчёте указаны проверенные страницы, выпуски, работающие операции и ограничения.
Новые источники добавляются отдельными проверенными адаптерами. Для каждого нужны понятная семантика поиска, ссылки и авторство, тесты изменения разметки и явные ограничения. Не добавляйте в репозиторий клиентские модели, изображения проектов, персональные оценки или ключи доступа.
Код и скилл: MIT. Сторонние материалы в репозиторий не включены.
Available Tools
4 toolsread_referenceARead-onlyIdempotent
Read a live OfficeNext project: authors, stated dates/materials, relevant text excerpts and all gallery image URLs. focus selects excerpts by keyword. Does not download images or infer visuals.
Inputs: url (required), focus.
reference_sourcesARead-onlyIdempotent
Report supported live sources and storage behavior; does not fetch or crawl.
Inputs: no named parameters.
search_referencesARead-onlyIdempotent
Search OfficeNext live by 1-4 Russian keywords or project name. Returns candidate project links, not verified design matches. Break complex briefs into several short queries. No database/index.
Inputs: query (required), page, limit.
view_reference_imageARead-onlyIdempotent
View ONE gallery photo from a verified OfficeNext project in memory, without a local image file. Use indices returned by read_reference. Image is max 1600px for visual review. Preserve attribution. Viewing a photograph does not establish hidden construction, dimensions, cost or acoustic performance.
Inputs: project_url (required), image_index. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct role: reporting sources, searching candidates, reading project details, and viewing a single gallery image. The search/read/view split is clear, and descriptions explicitly state boundaries such as search returning candidates versus read returning verified project content.
Three tools follow a clear verb_noun pattern: search_references, read_reference, view_reference_image. reference_sources is a noun phrase rather than an action, but it is still readable and semantically appropriate as a metadata/reporting tool.
Four tools are well scoped for a focused workflow around searching, reading, and visually inspecting OfficeNext references. It is slightly thin but each tool earns its place without unnecessary overlap.
The surface covers source discovery, keyword search, project reading, and image viewing, which is a coherent lifecycle for the stated reference-inspection purpose. Minor gaps include no browse/list operation independent of search and no batch image viewing, but these are workable limitations.
Maintenance
Related MCP Connectors
Search, read and save to your private vault of images, links and notes.
Live web research with related queries, browser-rendered sources, images, and evidence.
Search Envisioning's technology research, vocabulary and Hindsight graded forecasts. Read-only.
Multi-engine scholarly research server for search, traversal, full text, and reading lists.
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables MCP-compatible hosts to perform live web research, process local transcripts or text into headlines and keywords, and generate 3D office visualizations from processed data.3-
- AlicenseBqualityAmaintenanceEnables coding agents to discover live visual design references, inspect original sites as MCP images, analyze elements and motion, and verify implementation constraints during an original design workflow.17MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to search and read a local library of saved prompts, skills, MCP servers, and design boards, fill prompt blanks, and retrieve board design briefs through read-only, offline tools, prompts, and resources.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search, randomly roam, and inspect over 65,000 ArchDaily architectural works, including downloading and reading high-resolution images; it also supports notes, two-way sharing with a front-end canvas, and favorites/tag management.9MIT