MCP server that exposes ASCII and Unicode art tools
Valid MCP server (2 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
10 files analyzed ยท 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-theduodecim-ascii-art": {
"args": [
"-y",
"ascii-art-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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:
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.
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
This server is also published in the official Model Context Protocol Registry:
https://registry.modelcontextprotocol.io/?q=ascii-art
Server name:
io.github.theduodecim/ascii-art
This allows MCP-compatible tools to discover and install it automatically.
Development mode:
npm run dev
Build + production run:
npm run build
npm start
The server uses stdio transport and loads its data from:
db.json
located in the repository root.
Finds an art entry by exact nombre or by an exact value in aliases.
| Field | Type | Required |
|---|---|---|
| query | string | yes |
Returns the entry's art field as plain text.
Searches entries by categoria, tags, or both.
| Field | Type | Required |
|---|---|---|
| categoria | string | optional |
| tag | string | optional |
At least one filter is required.
Returns matching entries' art fields combined as text output.
Returns a random entry from the database.
| Field | Type | Required |
|---|---|---|
| tipo | ascii | unicode | required |
Returns the selected entry's art field as plain text.
Lists all unique categories present in the database.
None
Category names as newline-separated text.
Entries in db.json follow the AsciiArtEntry TypeScript interface:
src/types/asciiArt.ts
Each entry contains metadata such as:
A simple integration test was used to verify MCP communication using JSON-RPC over stdio.
Example test script (test.mjs):
import { spawn } from "child_process";
const proc = spawn("node", ["dist/server.js"], {
stdio: ["pipe", "pipe", "pipe"]
});
proc.stderr.on("data", (d) => {
console.log("LOG:", d.toString());
});
proc.stdout.on("data", (d) => {
console.log("SERVER:", d.toString());
});
function send(msg) {
const json = JSON.stringify(msg);
const payload = `Content-Length: ${Buffer.byteLength(json)}\r\n\r\n${json}\r\n`;
console.log("\nSENDING:\n", json, "\n");
proc.stdin.write(payload);
}
setTimeout(() => {
send({
jsonrpc: "2.0",
id: 1,
method: "initialize",
params: {
protocolVersion: "2024-11-05",
capabilities: {},
clientInfo: {
name: "tester",
version: "1.0"
}
}
});
}, 500);
setTimeout(() => {
send({
jsonrpc: "2.0",
method: "initialized",
params: {}
});
}, 1000);
setTimeout(() => {
send({
jsonrpc: "2.0",
id: 2,
method: "tools/list"
});
}, 1500);
setTimeout(() => {
proc.kill();
console.log("TEST FINISHED");
}, 4000);
src/
server.ts
tools/
types/
dist/
db.json
db.json)This project demonstrates how to build a simple MCP tool server that:
MIT
Be the first to review this server!
by Modelcontextprotocol ยท Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno ยท Developer Tools
Toleno Network MCP Server โ Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace ยท Developer Tools
Create, build, and publish Python MCP servers to PyPI โ conversationally.
by Microsoft ยท Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace ยท Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm โ conversationally
by mcp-marketplace ยท Finance
Free stock data and market news for any MCP-compatible AI assistant.