theduodecim avatar

Ascii Art

theduodecim/ascii-art-mcp

A local ASCII and Unicode art database that runs over stdio and requires no API keys. It exposes four tools: get_ascii_art for exact name lookups, search_ascii for filtering by category or tags, random_ascii for pulling a random entry by type, and list_categories for browsing what's available. The art lives in a local db.json file that ships with the server. Reach for this when you want to inject ASCII art into responses without maintaining your own collection or hitting external APIs. Built in TypeScript, runs on Node 20+, and works with Claude Desktop, Cursor, and other MCP clients.

tools
4
transport
STDIO
last updated
Mar 9, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

get_ascii_artFinds an art entry by exact nombre or by an exact value in aliases.

Finds an art entry by exact nombre or by an exact value in aliases.

No parameter schema in public metadata yet.

search_asciiSearches entries by categoria, tags, or both.

Searches entries by categoria, tags, or both.

No parameter schema in public metadata yet.

random_asciiReturns a random entry from the database.

Returns a random entry from the database.

No parameter schema in public metadata yet.

list_categoriesLists all unique categories present in the database.

Lists all unique categories present in the database.

No parameter schema in public metadata yet.

Sponsors

Readme

ascii-art-mcp

Ascii Art MCP server

ascii-art-mcp is a Model Context Protocol (MCP) server built with Node.js and TypeScript that exposes tools for retrieving ASCII and Unicode art from a local database.

The server communicates using stdio transport, making it compatible with MCP clients such as:

  • Claude Desktop
  • Cursor
  • LM Studio
  • Open WebUI
  • Other MCP-compatible environments

https://theduodecim.github.io/ascii-art-mcp/

▶ Run this MCP

Just drop this link into any MCP-compatible AI chat:

https://github.com/theduodecim/ascii-art-mcp/tree/main

"Run this MCP"

The AI will clone the repo, build it, and run it automatically. No setup needed on your end.


📦 Installation

The package is available on npm:

https://www.npmjs.com/package/ascii-art-mcp

Install locally:

npm install ascii-art-mcp

Or run directly:

npx ascii-art-mcp

🌐 MCP Registry

This server is also published in the official Model Context Protocol Registry:


View the full README on GitHub

Details

Repository
github.com/theduodecim/ascii-art-mcp
Package
ascii-art-mcp
Transport
STDIO
Registry
MCP registry, active