Skip to content
MCP server

nudg

Describe UI motion in a JSON file your AI can edit and a validator can check

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Web, iOS
Runs
Locally
Version
1.12.0
Listing updated
3 days ago

About nudg

nudg is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

nudg stores an interaction (its states, the events moving between them and the springs or gestures in between) in a small .nudg.json file beside a component. An AI coding tool edits the file, nudg validates the edit, and a small runtime plays it. The README compares the file to sheet music, runtimes to performance rules, the AI to an arranger and the developer to a director.

TypeScript, Swift and Kotlin runtimes play the same compiled program the same way, checked by a shared conformance suite, so one motion file serves web, iOS and Android. The nudg_compare tool plays two versions under the same tap and says whether a person would notice the change before showing before-and-after frames side by side. A live demo has 49 examples and a playground whose validator hints at misspelled keys.

Install

Run in a terminal

claude mcp add nudg -- npx -y @nudg/core

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "nudg": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nudg/core"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "nudg": {
      "command": "npx",
      "args": [
        "-y",
        "@nudg/core"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "nudg": {
      "command": "npx",
      "args": [
        "-y",
        "@nudg/core"
      ]
    }
  }
}

Tools this server provides (1)

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

nudg_compare
Plays two versions of an interaction and reports how noticeable the difference is.

What it does

Plain JSON motion
States, events and transitions in one file.
Validation
Checks AI edits and hints at misspelled keys.
Cross-platform runtimes
TypeScript, Swift and Kotlin.
Before/after comparison
Reports whether a change is noticeable.
Live playground
49 examples to edit and run.

Good for

  • Ask an AI to make a bounce springier
  • Compare two motion variants
  • Share one interaction spec across platforms
  • Check a gesture definition before shipping

Pricing

Open source

Open source; no paid plan listed

Prices change. Check seukwoo.github.io before you buy.

nudg FAQ

Which platforms are supported?

Web, iOS and Android through TypeScript, Swift and Kotlin runtimes.

How is the package installed?

Via npm as @nudg/core.

Can I try it first?

Yes, the demo and playground.

What does the compare tool do?

Plays both versions and describes how noticeable the difference is.

Is nudg free?

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

How do I add nudg to Claude Code?

Run this command in your terminal: claude mcp add nudg -- npx -y @nudg/core

What are the best alternatives to nudg?

The closest alternatives to nudg are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to nudg

  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. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. 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
  4. 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
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. 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