AI Vibe Craft
← Назад к AI Vibe News

Редакция 29 мая 2026 г.

Разборы

Unified MCP: дипломный агентный фреймворк, comeback через документацию и npm-пакет `unified-mcp`

Unified MCP: дипломный агентный фреймворк, comeback через документацию и npm-пакет `unified-mcp`. пост на Dev.to Студент B.

пост на Dev.to Студент B.Tech собрал Unified MCP Framework — оркестратор, который переводит запросы на естественном языке в цепочки вызовов MCP-инструментов с трассировкой во фронтенде. После защиты проект ушёл в архив, а затем вернулся как открытый пакет unified-mcp: автор утверждает, что за первую неделю после нормальной документации пакет набрал более 750 загрузок в npm — при том, что сам код, по его формулировке, почти не менялся.

Архитектура: чат, оркестратор и три MCP tool server'а

Слой для человека — React + Vite: чат и панель trace, где видно, какие инструменты отработали по шагам. За маршрутизацией NL-запросов стоит FastAPI-бэкенд; в описании дипломной сборки движком выбора инструментов назван Google Gemini.

Три специализированных сервера:

  • Filesystem — песочница для файловых операций;
  • Browser — автоматизация через Playwright;
  • GitHub — интеграция через PyGithub.

Типовой сценарий: запрос вроде «Summarize the latest commits in my repo and write a summary file» проходит цепочку GitHub tool → Filesystem tool → Gemini (summary); фронтенд показывает каждый шаг в trace panel. Это не абстрактный «чат с LLM», а явная агентная схема: модель решает, какой MCP-инструмент вызвать, а UI фиксирует цепочку.

Для разработчика MCP это учебный эталон: один оркестратор, несколько изолированных capability-серверов и наблюдаемость вызовов — без обязательной привязки к конкретной IDE.

От дипломного фреймворка к пакету unified-mcp

В заголовке Dev.to фигурирует MCP Agent Framework; в блоке Demo автор называет продукт Unified MCP Framework и даёт ссылки на репозиторий и npm.

Куда смотреть Значение
npm unified-mcp
GitHub Om-Shree-0709/Major-Project

На странице npm на момент проверки указаны версия 1.1.3, лицензия MIT, дата публикации 26 апреля 2026, автор omshree0709. Там же — CLI в духе npx unified-mcp с подкомандами reset, update, stop.

Расхождение Dev.to и npm. Текст поста описывает стек с Gemini и тремя серверами выше. Текущее README на npm шире: web search (DuckDuckGo), weather, выполнение Python-кода, system info.

Для API-ключей на npm упомянуты Groq и опциональный GitHub PAT; в дереве пакета есть, например, swarm_manager.py и weather_server.py — в трёх пунктах Dev.to они не названы. Для установки «как сейчас» логичнее сверяться с npm; для истории диплома — с постом. Провайдеры LLM в одном абзаце лучше не смешивать без явной оговорки.

Comeback: закрытый репозиторий и ставка на DX, а не на новый код

После сдачи B.Tech (PDF, презентация, постер) автор закрыл репозиторий и отошёл от кода. После выпускных экзаменов вернулся и увидел не «сломанное демо», а usability: чужому разработчику некуда было встать без чтения исходников.

До доработки, по его перечню:

  • нет install path без погружения в код;
  • README без вводного объяснения MCP;
  • нет .env.example;
  • настройка Playwright «в середине стены текста»;
  • пакет unified-mcp без примеров использования;
  • ошибки в виде сырых Python tracebacks.

После — quick-start в README, .env.example с комментариями, отдельные ветки setup для Windows и Unix (включая async event loop для Playwright на Windows), файлы QUICK_TEST_QUERIES.md и COMPLEX_TEST_QUERIES.md, понятные сообщения песочницы (Access denied: path is outside sandbox directory), troubleshooting и экспорт документации в npm.

Материал подан как submission for the GitHub Finish-Up-A-Thon Challenge; правил или итогов соревнования в доступном тексте нет — только контекст подачи.

Цифра 750+ и что видно в npm сегодня

В заголовке и секции «The Comeback Story» зафиксировано: в неделю после того, как проект «properly documented and re-announced», пакет набрал 750+ downloads; неделя без пригодной документации давала single digits. Ключевая мысль автора — код не менялся, менялись доки.

Независимого архива weekly downloads npm за ту «первую неделю» в материалах нет. На странице пакета сейчас отображается Weekly Downloads: 7 — снимок текущего окна npm, не эквивалент прошлой недели автора.

Сопоставлять «7» и «750+» как прямое опровержение или подтверждение нельзя без явного разделения периодов и метрик.

GitHub Copilot на втором проходе: где ИИ помогал, а где мешал

На этапе comeback к рутине вокруг MCP-проекта подключили GitHub Copilot — не к «магической» логике агентов, а к документации и обвязке. Copilot помогал со структурой README и последовательностью setup-команд, генерацией .env.example по образцу первой переменной, рефакторингом filesystem_server.py с user-facing errors по типам исключений и черновиком COMPLEX_TEST_QUERIES.md.

Ограничения сформулированы жёстко: модель может hallucinate import paths, предлагать несуществующие tools и конфликтующие FastAPI routes — правило «boilerplate yes, logic verify».

# Пример установки из README npm (проверяйте актуальную версию на странице пакета)
npm i unified-mcp
npx unified-mcp

Для экосистемы MCP вывод практичный: reference implementation с видимой трассой инструментов полезен сообществу, но без install path и примеров запросов агентный стек остаётся личным дипломом. Документация и CLI — такой же слой продукта, как сами серверы Filesystem, Browser и GitHub.

Источники

  • Пост @om_shree_0709 на Dev.to (архитектура, comeback, Copilot, заявление о 750+ загрузках): Dev.to
    Дата доступа: 2026-05-28 (UTC).
  • Страница npm-пакета unified-mcp (версия, CLI, текущие weekly downloads, README): https://www.npmjs.com/package/unified-mcp
    Дата доступа: 2026-05-28 (UTC).
  • Репозиторий проекта: https://github.com/Om-Shree-0709/Major-Project
    Дата доступа: 2026-05-28 (UTC).