MDMA MCP Server

@MobileReality

代码仓库主页

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

MobileReality

提交者

Mateusz Sadowski

关于 MDMA MCP Server

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

MDMA MCP Server 配置

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

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

MDMA MCP Server 工具

Returns the full MDMA specification: component types, schemas (as JSON Schema), binding syntax, external data sources ({ source, params } refs, the DataSourceDescriptor shape, and the rows / series / options kinds), and authoring rules

Returns a named MDMA prompt (mdma-author, mdma-reviewer, or mdma-fixer). For mdma-author, pass an optional variantId (e.g. "anthropic/sonnet-5.5", "openai/gpt-6-sol") 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. When dataSources (an external data-source catalog) is passed, returns the full system prompt instead: base MDMA spec, the data-source catalog with the rule to reference it via { source, params }, and the custom part.

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.

常见问题

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.