@mobile-reality/mdma-mcp

MCP-сервер (Model Context Protocol) для MDMA. Предоставляет ИИ-ассистентам спецификацию MDMA, промпты для авторов, метаданные пакетов и актуальную документацию с GitHub.

Инструменты

Related MCP server: Tambo Docs MCP Server

Установка

{
  "mcpServers": {
    "mdma": { "command": "npx", "args": ["@mobile-reality/mdma-mcp"] }
  }
}

Площадки для распространения

Места, где опубликован или должен быть опубликован MCP-сервер MDMA. У каждой площадки свой процесс отправки/обновления — при выпуске новой версии проверяйте каждую из них.

Чек-лист релиза — при обновлении версии

Используйте этот чек-лист каждый раз при публикации новой версии (0.2.4 → 0.2.5 и т.д.).

1. Обновление версии + тестирование

• [ ] Обновите version в package.json.

• [ ] Обновите строку version в src/index.ts (вызов McpServer({ version: ... })).

• [ ] Обновите version верхнего уровня и packages[0].version в server.json.

• [ ] Обновите version верхнего уровня и packages[0].version в manifest.json.

• [ ] Добавьте changeset: pnpm changeset в корне репозитория.

• [ ] Выполните pnpm build && pnpm test && pnpm typecheck в этом пакете.

2. Публикация в npm

• [ ] pnpm publish --access public --no-git-checks из этой директории.

• [ ] Проверка: npm view @mobile-reality/mdma-mcp version mcpName — оба значения должны совпадать.

3. Публикация в реестре MCP

• [ ] Убедитесь, что mcp-publisher авторизован: mcp-publisher login github (повторите авторизацию, если токены истекли).

• [ ] mcp-publisher publish из этой директории.

• [ ] Проверка: curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.MobileReality/mdma" показывает новую версию.

Не коммитьте .mcpregistry_github_token / .mcpregistry_registry_token — они находятся в .gitignore. Защита пуша GitHub в любом случае заблокирует отправку; это напоминание для подстраховки.

4. Тегирование релиза

git tag '@mobile-reality/mdma-mcp@<version>'
git push origin '@mobile-reality/mdma-mcp@<version>'

5. Сборка свежего бандла MCPB (только при отправке обновления Desktop Extension)

Виртуальное хранилище pnpm (.pnpm/) удаляется при mcpb pack, поэтому вы обязаны собирать бандл из чистой директории после установки npm, иначе транзитивные зависимости (например, ajv) будут отсутствовать.

Вывод: <name>-<version>.mcpb. Протестируйте установку в Claude Desktop, затем прикрепите как актив релиза GitHub.

6. Glama — если изменились описания инструментов или конфигурация Dockerfile

• [ ] Если вы добавили/переименовали/изменили описания инструментов: оценка качества Glama пересчитается при следующем периодическом сканировании. Ручной запуск не требуется.

• [ ] Если packages[0].version была обновлена: перейдите на страницу администратора Glama → обновите Build steps (npm install -g @mobile-reality/mdma-mcp@<version>) → Deploy → Make Release.

7. Уведомление зависимых компонентов

• [ ] Обновите таблицу инструментов MCP в корневом README.md, если инструменты были добавлены/переименованы/удалены.

• [ ] Обновите таблицу инструментов этого пакета (выше) аналогичным образом.

• [ ] Если есть критические изменения (breaking change): отметьте это в changeset; обновите потребителей createMdmaMcpServer(), если они есть.

Устранение неполадок

Ошибка 403 Forbidden при публикации в реестре MCP

Если ошибка гласит permission to publish: io.github.gitsad/*, io.github.MobileReality/*. Attempting to publish: io.github.mobilereality/mdma (несоответствие регистра): реестр чувствителен к регистру, и ваш mcpName / name в server.json должны в точности соответствовать каноническому регистру MobileReality на GitHub. Исправьте оба файла и переопубликуйте в npm (версии в npm неизменяемы).

Если ошибка гласит permission to publish: io.github.gitsad/* (организация отсутствует полностью): ваше членство в организации MobileReality на GitHub скрыто. Сделайте его публичным на https://github.com/orgs/MobileReality/people, затем выполните mcp-publisher logout && mcp-publisher login github для обновления JWT.

Сбой .mcpb при установке в Claude Desktop

Обычно это ошибки "missing module" в логах вкладки Developer. Причина: вложенное виртуальное хранилище pnpm .pnpm/ было удалено во время упаковки, поэтому транзитивные зависимости отсутствуют. Решение: соберите бандл из чистой директории после установки npm (см. шаг 5 выше). Не запускайте mcpb pack напрямую для packages/mcp/node_modules.

Утечка секретов в бандл

mcpb pack не учитывает .gitignore. Любой файл .mcpregistry_*_token рядом с манифестом во время упаковки будет добавлен в .mcpb. Всегда удаляйте их перед упаковкой и отдавайте предпочтение рабочему процессу /tmp/mcpb-build (описанному выше), в директории которого нет токенов.

Файлы в этом пакете