MDMA
@MobileReality
关于 MDMA
Interactive documents from Markdown. Extends MD with forms, approvals, webhooks, and more — built for next gen apps
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"mdma": {
"command": "npx",
"args": [
"@mobile-reality/mdma-mcp"
]
}
}
}工具
8Returns 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-spectool. - 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.
What are the runtime requirements?
The server runs via npx and therefore requires Node.js and npm. No other runtime dependencies are documented.
其他 分类下的更多 MCP 服务器
Awesome-MCP-ZH
yzflyMCP 资源精选, MCP指南,Claude MCP,MCP Servers, MCP Clients
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Servers
modelcontextprotocolModel Context Protocol Servers
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
评论