Skip to content
MCP server

Mdma

Serves the MDMA spec, authoring prompts and docs to AI assistants

Runs locallyActively maintainedStatus and history

The repository was last updated 25 days ago and is published under MIT.

Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
GitHub stars
77
Last commit
25 days ago
Language
TypeScript

About Mdma

Mdma is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

MDMA is a Markdown extension in which an LLM writes interactive components, such as forms, tables and approval gates, inside fenced mdma blocks that a renderer turns into live UI. This server gives an assistant what it needs to write and check those blocks: the full spec, ready-made prompts and the project's documentation.

The prompt tools return named prompts for authoring, reviewing and fixing, with model-specific variants for the author prompt. A builder generates a custom prompt from a domain, components, fields, steps and business rules, optionally including a catalogue of external data sources, and another tool validates a custom prompt against MDMA conventions. Documentation is fetched live from the public GitHub repository, with an optional branch, tag or SHA.

It runs over stdio from the npm package @mobile-reality/mdma-mcp and needs no environment variables. The MDMA framework itself renders in React, Vue and React Native and is built by Mobile Reality.

Install

Run in a terminal

claude mcp add mdma -- npx -y @mobile-reality/mdma-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mdma": {
      "command": "npx",
      "args": [
        "-y",
        "@mobile-reality/mdma-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mdma": {
      "command": "npx",
      "args": [
        "-y",
        "@mobile-reality/mdma-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mdma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mobile-reality/mdma-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

get-spec
Return the full MDMA specification
get-prompt
Return a named MDMA prompt, optionally a model-optimised variant
list-prompt-variants
List available author prompt variants
build-system-prompt
Generate a custom MDMA prompt from structured input
validate-prompt
Validate a custom prompt against MDMA conventions
list-packages
List MDMA npm packages with install commands
list-docs
List documentation files in the public repository
get-doc
Fetch the latest version of a doc from GitHub

What it does

Full spec access
Returns component types, JSON schemas, binding syntax and authoring rules.
Named prompts
Author, reviewer and fixer prompts, with model-optimised author variants.
Prompt builder
Generates a custom prompt from domain, components, fields, steps and rules.
Prompt validation
Checks a custom prompt against MDMA conventions.
Package catalogue
Lists MDMA npm packages with install commands and usage examples.
Live docs
Fetches the latest docs from GitHub at a branch, tag or SHA.

Good for

  • Have an assistant write a valid MDMA form or approval gate
  • Review or repair an MDMA document with the fixer prompt
  • Generate a system prompt for a domain-specific MDMA agent
  • Look up which MDMA package renders for Vue or React Native
  • Read the latest MDMA docs without leaving the editor

Pricing

Open source

Prices change. Check mdma.software before you buy.

Mdma FAQ

How do I install it?

Add an mcpServers entry that runs npx with @mobile-reality/mdma-mcp.

Does it need configuration?

No environment variables are required.

Where do the docs come from?

The get-doc tool fetches them from the public MobileReality/mdma GitHub repository.

Which prompts are available?

mdma-author, mdma-reviewer and mdma-fixer.

Is Mdma free?

Yes. Mdma is open source, so you can use and self-host it for free.

How do I add Mdma to Claude Code?

Run this command in your terminal: claude mcp add mdma -- npx -y @mobile-reality/mdma-mcp

What are the best alternatives to Mdma?

The closest alternatives to Mdma are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Mdma

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools