ASCII Banner MCP Server
This MCP server generates ASCII art banners from text strings using various pyfiglet fonts.
List available fonts (
get_fonts): Retrieve a complete list of all available pyfiglet font names (e.g.,'slant','standard','block','bubble','big') to discover options before generating banners.Generate ASCII art banners (
generate_banner): Convert any text string into a multi-line ASCII art banner, with an optional font name (defaults to'standard').
ASCII Banner MCP Server
A classical Model Context Protocol (MCP) server that generates ASCII art banners from any string using pyfiglet.
Features
get_fonts— List all available pyfiglet font names (viaFigletFont.getFonts()).generate_banner— Render a string as ASCII art with a chosen font (viafiglet_format(text, font=...)).
Related MCP server: whereami-mcp
Requirements
Python ≥ 3.10
mcp,pyfiglet
Installation
From the project root:
pip install -e .For development (tests):
pip install -e ".[dev]"Usage
Run the server (stdio)
MCP clients typically run the server as a subprocess and talk over stdio:
python -m ascii_banner_mcp.serverOr after install:
ascii-banner-mcpConfig example
Copy and adjust one of the examples in config/:
stdio (local):
config/mcp-config.example.json—command+argsfor Cursor, Claude Desktop, etc.streamable-http (e.g. Docker):
config/mcp-config-streamable-http.example.json—url: "http://localhost:8000/mcp"when the server runs over HTTP.
Configure your MCP client
Add the server to your MCP client config (e.g. Cursor, Claude Desktop). Example (stdio):
{
"mcpServers": {
"ascii-banner": {
"command": "python",
"args": ["-m", "ascii_banner_mcp.server"]
}
}
}If you use a virtualenv, use the full path to that Python:
{
"mcpServers": {
"ascii-banner": {
"command": "/path/to/venv/bin/python",
"args": ["-m", "ascii_banner_mcp.server"]
}
}
}Tools
Tool | Description |
| Returns a list of available font names. Use this to discover fonts for |
| Renders |
Example (equivalent to your snippet):
from pyfiglet import figlet_format
print(figlet_format("Hello", font="slant"))Via this MCP server: call generate_banner with text="Hello" and font="slant".
MCP Inspector
Use MCP Inspector to test and debug the server.
Option 1 — stdio (local process)
Run the Inspector:
npx @modelcontextprotocol/inspectorIn the UI, add a server with Stdio transport.
Set Command to
python(or full path to your Python/venv).Set Args to
-m,ascii_banner_mcp.server.Ensure the project is installed (
pip install -e .) or set cwd to the project root and usepython -m ascii_banner_mcp.server.
Option 2 — streamable-http (Docker or local)
Start the server over HTTP:
Docker:
docker compose -f .docker/docker-compose.yml up --build(see Docker below).Local:
MCP_TRANSPORT=streamable-http python -m ascii_banner_mcp.server(serves athttp://127.0.0.1:8000/mcp).
Run the Inspector:
npx @modelcontextprotocol/inspectorAdd a server with Streamable HTTP (or URL) and set the URL to
http://localhost:8000/mcp.
Custom ports (Inspector):
CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector
Docker
Run the MCP server in a container. Use the .docker/ setup:
stdio (default) — client runs the container and talks via stdin/stdout:
docker build -f .docker/Dockerfile -t ascii-banner-mcp .
docker run -i --rm ascii-banner-mcpstreamable-http (for Inspector or URL-based clients):
docker compose -f .docker/docker-compose.yml up --buildServer is at http://localhost:8000/mcp. Use config/mcp-config-streamable-http.example.json or point MCP Inspector at that URL.
Development
Tests:
pytestLint:
ruff check src testsFormat:
black src testsPre-commit: Black, Ruff, and conventional-commit message checks (e.g.
feat:,fix:). Install:pip install -e ".[dev]"thenpre-commit installandpre-commit install --hook-type commit-msg. Run manually:pre-commit run --all-files.
License
MIT
Available Tools
2 toolsgenerate_bannerA
Generate an ASCII art banner from the given string.
Args:
text: The string to render as ASCII art (e.g. "Hello", "MCP").
font: Name of the pyfiglet font. Use get_fonts() to list available fonts.
Default is "standard". Common options: "slant", "block", "bubble", "big".
Returns:
The ASCII art banner as a multi-line string.
Inputs: text (required), font. Returns: result
get_fontsA
List all available pyfiglet font names.
Returns a list of font identifiers that can be used with generate_banner.
Use this to discover which fonts (e.g. 'slant', 'standard', 'block') are available.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have perfectly distinct purposes: generate_banner creates ASCII art from text, while get_fonts lists available fonts. There is no overlap or ambiguity between them; an agent can easily tell them apart based on their clear, complementary functions.
Both tools follow a consistent verb_noun pattern: generate_banner and get_fonts. The naming is predictable and readable, with no deviations or mixed conventions, making it easy for an agent to understand and use them.
With only 2 tools, this server feels thin for its apparent scope of ASCII banner generation. While the tools cover core functionality, the count is too low for a typical server, limiting flexibility and potentially requiring agents to work around missing operations like customization or management features.
The server covers basic ASCII banner generation with text input and font selection, but there are notable gaps. For example, it lacks tools for customizing banners (e.g., adjusting width, alignment, or colors) or managing generated banners, which could hinder more advanced agent workflows in this domain.
Maintenance
Related MCP Connectors
A simple MCP server built with FastMCP and python
An MCP server that measures MCP client behaviour and converts EBCDIC to ASCII, which nobody needs.
An MCP server that provides asset auto generator
Related MCP Servers
- MIT
- AlicenseNot gradedqualityDmaintenanceA lightweight mcp server that tells you exactly where you are.4MIT
- AlicenseAqualityDmaintenanceA lightweight MCP server that tells you exactly who you are.11MIT
- FlicenseAqualityDmaintenanceA simple MCP server that provides greeting tools and server information.1-