MDMA

Name: MDMA
Author: MobileReality

@MobileReality

代码仓库

关于 MDMA

Interactive documents from Markdown. Extends MD with forms, approvals, webhooks, and more — built for next gen apps

#mdma #markdown #generative-ui #llm #structured-output #ai-agents #forms #interactive-documents #react #model-context-protocol

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

MobileReality

提交者

Mateusz Sadowski

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Returns the full MDMA specification: component types, schemas (as JSON Schema), binding syntax, and authoring rules

Returns a named MDMA prompt (mdma-author, mdma-reviewer, or mdma-fixer). For mdma-author, pass an optional variantId (e.g. "google/gemini-2.5-pro") to get the model-optimised variant — use list-prompt-variants to see all available ids.

Returns all available MDMA_AUTHOR prompt variants with their id, label, and description. Pass the id to get-prompt as variantId to retrieve the model-optimised prompt.

Generates a custom MDMA prompt from structured input (domain, components, fields, steps). Returns only the custom prompt part — use buildSystemPrompt({ customPrompt }) in code to combine it with the base MDMA spec.

Validates a custom prompt against MDMA conventions. Returns warnings for anti-patterns and suggestions for improvements.

Returns all MDMA npm packages with their purpose, install command, usage example, and category

Returns the catalog of MDMA documentation files available for fetching from the public GitHub repo (path, title, description). Use this to discover what docs you can pass to get-doc.

Fetches the latest version of an MDMA documentation file from the public GitHub repo (raw.githubusercontent.com/MobileReality/mdma) and returns its contents as text. Allowed paths: any entry from list-docs, plus any *.md file under "docs/" or "blueprints/". Defaults to the "main" branch.

概览

What is MDMA?

MDMA is an MCP (Model Context Protocol) server that exposes the MDMA specification, authoring prompts, package metadata, and live GitHub documentation to AI assistants. It is built and published by MobileReality as the npm package @mobile-reality/mdma-mcp.

How to use MDMA?

Add the following to your MCP client configuration:

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

No further explicit usage instructions are provided.

Key features of MDMA

Provides full MDMA specification via get-spec tool.
Returns authoring, reviewing, and fixing prompts via get-prompt.
Lists available prompt variants for model-optimised prompts.
Generates custom MDMA prompts from structured input.
Validates custom prompts against MDMA conventions.
Lists MDMA npm packages with install commands and examples.
Retrieves up-to-date documentation from the public GitHub repository.

Use cases of MDMA

AI-assisted authoring of MDMA component specifications.
Reviewing and fixing existing MDMA prompts with model-optimised variants.
Fetching the latest MDMA docs directly into an AI conversation.
Building and validating custom prompts for specialised MDMA workflows.
Exploring MDMA npm packages and their usage from an AI assistant.

FAQ from MDMA

What tools does the MDMA MCP server offer?

It offers eight tools: get-spec, get-prompt, list-prompt-variants, build-system-prompt, validate-prompt, list-packages, list-docs, and get-doc.

Why does MCP Registry publish fail with 403 Forbidden?

The registry is case‑sensitive; the mcpName and server.json name must exactly match the GitHub organisation’s canonical capitalisation (MobileReality, not mobilereality). If the error mentions a missing org, verify your GitHub membership is public.

How do I build a Desktop Extension (.mcpb) bundle?

Build from a clean npm‑installed directory to avoid missing transitive dependencies. Do not run mcpb pack directly from the repository because pnpm’s virtual store strips .pnpm/ folders.

Where does the server fetch documentation from?

The get-doc tool fetches the latest version of a document from raw.githubusercontent.com/MobileReality/mdma, optionally at a specific branch, tag, or SHA.