AI-Powered ASCII Art with MCP

New Feature

The ASCII Motion MCP Server enables AI assistants to create, animate, and export ASCII art through natural language prompts.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to interact with external tools and services. ASCII Motion's MCP server provides 69 tools for complete control over ASCII art creation.

What Can You Do?

With the ASCII Motion MCP, you can ask your AI assistant to:

Create art from descriptions - "Draw a pixel art spaceship"
Animate - "Create an 8-frame walking animation"
Import images - "Convert this photo to ASCII using block characters"
Apply effects - "Add a digital rain effect with green text"
Export - "Save as a GIF" or "Export as a React component"

Supported AI Clients

The MCP server works with any MCP-compatible AI assistant:

Client	Platform	Guide
Claude Desktop	macOS, Windows	Full setup guide
VS Code + Copilot	VS Code	MCP configuration
Cursor	macOS, Windows, Linux	Editor setup
Windsurf	macOS, Windows, Linux	Editor setup

Quick Start

1. Install the MCP Server

bash

npm install -g ascii-motion-mcp

2. Configure Your AI Client

Add ASCII Motion to your client's MCP configuration with live mode. For example, in Claude Desktop:

json

{
  "mcpServers": {
    "ascii-motion": {
      "command": "ascii-motion-mcp",
      "args": ["--live", "--project-dir", "/path/to/projects"]
    }
  }
}

Live Mode Required

The --live flag enables real-time sync with the browser. Without it, there's no visual output for your AI's work.

3. Connect the Browser

Ask your AI: "What is the MCP auth token?"
Open ascii-motion.app
Click the hamburger menu (☰) → MCP Connection
Paste the token and click Connect

4. Start Creating!

"Create a new 40x20 canvas and draw a red pixel art heart in the center"

Tool Categories

The MCP server provides 69 tools across these categories:

Canvas (8 tools) - Draw, fill, resize, clear
Frames (7 tools) - Add, delete, duplicate, navigate
Animation (5 tools) - Copy/modify, shift, flip, interpolate
Selection (6 tools) - Rectangle, color-based, apply operations
Palettes (9 tools) - Character sets, color schemes, style suggestions
Import (3 tools) - Images, video, ASCII text
Effects (4 tools) - Apply visual effects, recolor, replace
Generators (2 tools) - Digital rain, noise, particles
Export (11 tools) - Images, video, HTML, React, CLI frameworks
Project (6 tools) - New, save, load, list files
Preview (5 tools) - Summaries, diffs, ASCII previews
History (3 tools) - Undo, redo, status