ascii‑art‑mcp

ascii‑art‑mcp ist ein Model Context Protocol (MCP)‑Server, der mit Node.js und TypeScript entwickelt wurde und Werkzeuge zum Abrufen von ASCII‑ und Unicode‑Kunst aus einer lokalen Datenbank bereitstellt.

Der Server nutzt den stdio‑Transport und ist dadurch mit MCP‑Clients wie den folgenden kompatible:

• Claude Desktop

• Cursor

• LM Studio

• Open WebUI

• Weitere MCP‑kompatible Umgebungen

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

▶ Dieses MCP ausführen

Füge diesen Link in einen beim Contact any MCP‑kompatible KI‑hat ein:

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

„Dieses MCP ausführen"

Die KI wird das Repository klonen, bauen und automatisch ausführen. Auf deiner Seite ist keine Einrichtung nötig.

📦 Installation

Das Paket ist auf npm verfegbar:

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

Lokal installieren:

npm install ascii-art-mcp

Oder direkt ausführen:

npx ascii-art-mcp

🌐 MCP Registry

Dieser Server ist auch in der offiziellen Model Context Protocol Registry veröffentlicht:

https://registry.modelcontextprotocol.io/?q=ascii-art

Serverame:

io.github.theduodecim/ascii-art

Das MCP‑kompatible Tools ihn automatisch entdecken und installieren.

Voraussetzungen

• Node.js 20+

• npm

Den Server manuell ausführen

Entwicklungsmodus:

npm run dev

Build + Produktionslauf:

npm run build
npm start

Der Server verwendet den stdio‑Transport und lädt seine Daten aus Datei GXP7, die im Stammverzeichnis des Repositoriums liigt.

Verfgbare MCP‑Tools

Related MCP server: MusicBrainz MCP Server

get_ascii_art

Findet einen art‑Eintrag anhand des exakten Namens oder eines exakten Werts in aliases.

Eingabe

Ausgabe

Gibt das art‑Feld des Eintrags als Rahrtext zurück.

search_search

Sucht Einträge nach categoria, tags oder beides.

Eingabe

Mindestens ein Filter ist erforderlich.

Ausgabe

Gibt die art‑Felder der übereinstimmenden Einträge als ter Textausgabe zurück.

random_ascii

Et.

Gibt einen zufälligen Eintrag aus der Datebank zurück.

Eingabe

Ausgabe

Gibt des art‑Feld des ausgewählten Einträts als Rahrtext zurück.

list_list

Lteste alle eindeutigen Kategorien aus der Datenbank auf.

Eingabe

Keine

Ausgabe

Kategorienamen als durch Zilenumbrüche getrennte Text.

🗂 Datemodell

Einträge in db.json dem AsciiArtEntryTypeScript‑Schnittstelle: folgen.

src/types/asciiArt.ts

Jeder Eintrag enthält Metadaten wie:

• name

• category

• tags

• aliases

• art‑Inhalt

🧪 MCP‑Server testen

Zum Prüfen der MCP‑Kommunikation über JSON‑RPC über stdio wurde ein einfacher Integrationstest verwendet.

Beispielskript (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);

🧠 Architektur

src/
  server.ts
  tools/
  types/

dist/

db.json

• TypeScript‑MCP‑Server

• JSON‑Datenbank (db.json)

• Zod‑Validierung der Tool‑Eingaben

• stdio‑Transport

🎨 Zweck

Dieses Projekt zeigt, wie man einen einfachen MCP‑Tool‑Server erstellt, der:

• local läuft

• keine API‑Keys benötigt

• strukturierte Tools bereitstellt

• statische Daten über MCP ausliefert

📜 Lizenz

MIT