Artscii

by rxolve

301 downloads
Not rated
GitHub

About

ASCII art & kaomoji search for AI agents. 58 arts + 90 kaomoji. Search, convert images, get random art via MCP.

Details

Author
rxolve
Downloads
301
Categories
Other

- 58 built‑in ASCII arts in three size tiers (16w, 32w, 64w)
- 90 kaomoji across 22 emotion/theme categories
- Search art and kaomoji by query or category
- Convert images to ASCII art via URL or base64
- Submit and delete user‑contributed art

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Artscii
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run the MCP server with npx -y artscii and configure it in your MCP client (e.g., Claude Desktop, Cursor). Alternatively, start the REST API server with npx artscii and access endpoints like GET /search?q={query}. Use MCP tools such as search, kaomoji, get, random, list, submit, convert, and delete.

search

Search ASCII art and kaomoji. Omit query to list all. Use random for a random entry. Use mode "categories" to list categories.

get

Get ASCII art by ID.

banner

Render text as a large ASCII banner using FIGlet fonts. Great for CLI headers, welcome messages, and titles.

kaomoji

Get a kaomoji (Japanese text emoticon) by emotion or keyword. Perfect for inline text expressions.

frame

Draw a box/frame around text. Styles: single, double, rounded, bold, ascii.

chart

Render data as ASCII charts. Types: progress (bar), sparkline (trend), heatmap (2D grid).

compose

Combine multiple text blocks side-by-side or stacked.

animate

Compose ASCII animations: combine any art with a motion. Motions: bounce, shake, blink, slide, reveal, fade, pulse, rain, progress, wave, jump, talk. Returns a bash script or raw frames.

convert

Convert an image (URL or base64) to ASCII art. Modes: "ascii" (character ramp) or "braille" (2x4 dot grid, higher fidelity).

character

Generate a unique ASCII character from a seed. 153600 possible combinations (16 species × 10 eyes × 8 mouths × 10 hats × 12 accessories). Same seed always produces the same character. Use mood for quick expression presets. Output can be piped to the animate tool.

diagram

Generate ASCII diagrams: flowcharts, boxes, trees, tables, sequence, timeline, bar, class, ER, mindmap, and gantt.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "artscii": {
            "artscii": {
                "command": "npx",
                "args": [
                    "-y",
                    "artscii"
                ]
            }
        }
    }
}

McpServers

{
    "artscii": {
        "command": "npx",
        "args": [
            "-y",
            "artscii"
        ]
    }
}

artscii

npm

ASCII art & kaomoji for AI agents, CLI tools, and chatbots.
58 built-in arts + 90 kaomoji, searchable via MCP or REST API.

     .::-::.         .:-::.        --- apple (16w) ---
  .=#%@@@@@%#=:  .=%@@@@@%#+:           +:
 -%@@@@@@@@@@@%+%@@@@@@@@@@@%+      :--:#.--:
.%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@-    -#@@@@#%@@@@%=
-@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@   :@@@%*+#%@@@:
.%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@=   -@%%%+@@+@%%@-
 =@@@@@@@@@@@@@@@@@@@@@@@@@@@@     @@%++#=#%@@#
  -#@@@@@@@@@@@@@@@@@@@@@@@@%=       +%@@@#@@@@%+
    =%@@@@@@@@@@@@@@@@@@@@%.         .-+=+=.
      =#@@@@@@@@@@@@@@@@%+.
        =#@@@@@@@@@@@@%+.    ʕ•ᴥ•ʔ  (◕‿◕)  (╯°□°)╯︵ ┻━┻
          -#@@@@@@@@%+.
            -#@@@@%=.
              -#=

Use Cases

Give your CLI personality. Replace boring spinners with ASCII art loading screens, success badges, or error illustrations.

import { execSync } from 'child_process';
// npx artscii runs the MCP server — or just fetch from the REST API:
const art = await fetch('http://localhost:3001/art/trophy/raw').then(r => r.text());
console.log(art); // 16w trophy on build success

Make chatbots expressive. Discord/Slack bots can react with kaomoji that match the mood — no custom emoji uploads needed.

const res = await fetch('http://localhost:3001/kaomoji?q=celebrate');
const [first] = await res.json();
bot.reply(Deploy complete! ${first.text}); // Deploy complete! (ノ◕ヮ◕)ノ:・゚✧

Add visuals to AI agents without wasting tokens. A 16w art is only 8 lines — far cheaper than describing an image in natural language.

{
  "mcpServers": {
    "artscii": { "command": "npx", "args": ["-y", "artscii"] }
  }
}

> "Show me a cat" → MCP search("cat") → returns 32w cat silhouette + ฅ•ω•ฅ kaomoji

Install

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.