# MobileReality/mdma [Health: Active]

**Category:** 🔄 Version Control  
**Repository:** https://github.com/MobileReality/mdma/tree/main/packages/mcp  
**GitHub Stars:** 72  
**npm Downloads (last month):** 239  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mobilereality-mdma

## Description
MCP server for MDMA (interactive Markdown applications with mounted components). Exposes the MDMA spec, authoring prompts, package metadata, and live docs to AI assistants. Tools: get-spec, get-prompt, build-system-prompt, validate-prompt, list-packages, list-docs, get-doc. Install: npx @mobile-reality/mdma-mcp.

## Tools
Capabilities this server exposes over MCP:

- **get-spec** — 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
- **get-prompt** — 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.
- **list-prompt-variants** — 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.
- **build-system-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.
- **validate-prompt** — Validates a custom prompt against MDMA conventions. Returns warnings for anti-patterns and suggestions for improvements.
- **list-packages** — Returns all MDMA npm packages with their purpose, install command, usage example, and category
- **list-docs** — 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.
- **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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What MobileReality/mdma MCP server does

MobileReality/mdma MCP server exposes reference material and authoring utilities for MDMA, a format for interactive Markdown applications with mounted components. It gives an AI assistant access to the complete MDMA specification, including component types, JSON schemas, binding syntax, authoring rules, and external data-source references.

The server also covers the practical workflow around MDMA projects. Agents can retrieve named prompts for authoring, reviewing, and fixing MDMA content; inspect MDMA npm packages; and browse documentation files published in the project's public GitHub repository.

## How it works

The package implements MCP tools that return structured or text-based MDMA resources to a connected assistant. `get-spec` returns the full specification, while `get-prompt` retrieves one of the named prompts. The authoring prompt can be selected by model variant, such as a variant identified for a particular model family. `list-prompt-variants` provides the available identifiers before the prompt is fetched.

For prompt generation, `build-system-prompt` accepts structured project information such as the domain, components, fields, workflow steps, and business rules. It can also receive a catalog of external data sources. These sources use `rows`, `series`, or `options` entries, and generated prompts describe references using `{ source, params }`.

Documentation access is split into discovery and retrieval. `list-docs` returns the available files, and `get-doc` fetches the current file from the public GitHub repository. A branch, tag, or commit SHA can be supplied to retrieve a particular revision.

## Setup and configuration

Install and launch the server through npm with:

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

This configuration starts `@mobile-reality/mdma-mcp` as a stdio MCP server. No environment variables are required by the documented setup. The package can be connected from clients that support standard MCP stdio servers, including Claude Desktop.

## Tools and capabilities

- `get-spec`: Retrieve the complete MDMA specification.
- `get-prompt`: Fetch the author, reviewer, or fixer prompt, including an optional authoring variant.
- `list-prompt-variants`: Discover available model-oriented authoring prompt IDs.
- `build-system-prompt`: Create a custom MDMA system prompt from structured inputs and data-source definitions.
- `validate-prompt`: Check a custom prompt against MDMA conventions.
- `list-packages`: List MDMA npm packages with their purpose, installation command, example usage, and category.
- `list-docs`: Browse documentation files available from the public repository.
- `get-doc`: Fetch a documentation file, optionally at a selected Git revision.

## Limitations and notes

The documentation tool reads from the public `MobileReality/mdma` GitHub repository, so retrieved content follows the selected repository revision. Model-optimized authoring prompts must first be selected from the identifiers returned by `list-prompt-variants`. The server focuses on MDMA reference, prompt, metadata, and documentation operations; it is not described as an execution environment for running MDMA applications.

_Full upstream README: https://allmcps.com/mcp/mobilereality-mdma/readme_