Parseltongue MCP Server 🐍

A Model Context Protocol (MCP) server providing direct text encoding tools plus a consumer bridge for the current P4RS3LT0NGV3 transform catalog.

Features

🧬 P4RS3LT0NGV3 Consumer Bridge

• list_p4rs_transforms: Discover transforms from the local P4RS3LT0NGV3/src/transformers tree.
• apply_p4rs_transform: Apply any discovered P4RS transform by id or display name.
• decode_p4rs_transform: Decode/reverse any discovered reversible transform.
• Set P4RS3LT0NGV3_PATH if the repo is not at ~/git/P4RS3LT0NGV3.

🔤 Custom Spelling Alphabets

• encode_spelling_alphabet: Encode text with a custom ICAO-style A-Z alphabet JSON map.
• decode_spelling_alphabet: Decode spelling-alphabet text back to letters.

🔳 QR Codes & Barcodes

• generate_qr_code_svg and generate_qr_code_data_uri for QR code generation.
• generate_barcode_svg for Code 128, Code 39, and EAN-13 SVG generation.

📦 Basic Encodings (22 tools)

• Base64: Encode/decode Base64
• Base64URL: Encode/decode Base64 URL-safe format
• Base32: Encode/decode Base32
• Base58: Encode/decode Base58 (Bitcoin-style)
• Base62: Encode/decode Base62
• Base45: Encode/decode Base45
• ASCII85: Encode/decode ASCII85
• Hexadecimal: Encode/decode hex
• Binary: Encode/decode 8-bit binary
• URL Encoding: Percent encoding for URLs
• HTML Entities: Encode/decode HTML entities

🔐 Ciphers (8 tools)

• ROT13: Classic rotation cipher (encode/decode)
• Caesar Cipher: Custom shift cipher (encode/decode)
• Atbash: Reverse alphabet substitution (encode/decode)
• Morse Code: Encode/decode to Morse code

🎨 Unicode Transformations (6 tools)

• Zalgo Text: Glitch effect with combining marks
• Upside Down: Flip text using Unicode
• Bubble Text: Circle-enclosed letters (Ⓐⓑⓒ)
• Full Width: Vaporwave aesthetic (ｆｕｌｌ　ｗｉｄｔｈ)
• Strikethrough: S̶t̶r̶i̶k̶e̶t̶h̶r̶o̶u̶g̶h̶
• Underline: U̲n̲d̲e̲r̲l̲i̲n̲e̲d̲

🕵️ Steganography (3 tools)

• Zero-Width Encoding: Hide text using invisible Unicode characters (encode/decode)
• Invisible Ink: Hide messages within cover text

🔧 Utilities (2 tools)

• Reverse Text: Simple string reversal
• Pig Latin: Classic word game transformation

Installation

# Clone the repository
git clone 
cd parseltongue_mcp

# Install dependencies using uv
uv sync

# Or using pip
pip install -e .

Usage

As an MCP Server

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "parseltongue": {
      "command": "uv",
      "args": [
        "--directory",
        "(Full path)/parseltongue_mcp",
        "run",
        "parseltongue-mcp"
      ]
    }
  }
}

Running Directly

# Using uv
uv run parseltongue-mcp

# Or with python