MCP Server

The AI Markdown Workspace MCP server brings professional Markdown conversion to your AI assistants. Connect Claude Desktop, VS Code, or any MCP-compatible client to convert Markdown to HTML, DOCX, and PDF with beautiful themes — all from within your chat interface.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI applications to securely interact with external tools and data sources. By running the AI Markdown Workspace MCP server, your AI assistant gains the ability to convert Markdown content without leaving the conversation.

Installation

Prerequisites

• Python 3.9 or higher
• A valid license key from Adoneinu
• An MCP-compatible client (Claude Desktop, VS Code with MCP extension, etc.)

Install the MCP Server

# Clone the repository
git clone https://github.com/adoneinu/mdconverter.git
cd mdconverter

# Install dependencies
pip install -r requirements.txt

# Or install as a package
pip install md-converter-mcp

Configuration

1. Set Your License Key

The MCP server requires a license key for authentication. Set it as an environment variable:

# Linux / macOS
export MD_CONVERTER_LICENSE="your-license-key-here"

# Windows (PowerShell)
$env:MD_CONVERTER_LICENSE="your-license-key-here"

# Windows (Command Prompt)
set MD_CONVERTER_LICENSE=your-license-key-here

2. Configure Your MCP Client

{
  "mcpServers": {
    "md-converter": {
      "command": "python",
      "args": ["/path/to/mdconverter/mcp_server.py"],
      "env": {
        "MD_CONVERTER_LICENSE": "your-license-key-here"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "md-converter": {
        "command": "python",
        "args": ["/path/to/mdconverter/mcp_server.py"],
        "env": {
          "MD_CONVERTER_LICENSE": "your-license-key-here"
        }
      }
    }
  }
}

python mcp_server.py --license-key YOUR_KEY --port 3100

Available Tools

The MCP server exposes the following tools that your AI assistant can use:

convert_markdown

Convert Markdown content to the specified format with optional theme customization.

Parameters

Example Usage

Use the convert_markdown tool to transform this Markdown:

# Hello World

This is **bold** and this is *italic*.

Into a PDF with the "minimal" theme.

Response

{
  "filename": "document.pdf",
  "content_base64": "JVBERi0xLjQK...",
  "content_type": "application/pdf"
}

list_themes

Retrieve all available conversion themes with their color palettes and descriptions.

Parameters

This tool takes no parameters.

Example Usage

What themes are available for conversion? List them with their color schemes.

Response

[
  {
    "id": "corporate",
    "name": "Corporate Blue",
    "description": "Professional blue theme for business documents",
    "colors": {
      "heading": "#1e3a5f",
      "text": "#333333",
      "bg": "#ffffff",
      "link": "#0066cc",
      "accent": "#4a90d9"
    }
  },
  ...
]

preview_markdown

Get a styled HTML preview of Markdown content without downloading a file.

Parameters

Example Usage

Show me a preview of this Markdown with the "neon" theme:

## Features

- Fast conversion
- Beautiful themes
- Multiple export formats

batch_convert

Convert multiple Markdown documents at once. Each document can have its own filename.

Parameters

Example Usage

Convert these three documents to PDF using the corporate theme:
- Document 1: "# Chapter 1\n\nIntroduction..."
- Document 2: "# Chapter 2\n\nMain Content..."
- Document 3: "# Chapter 3\n\nConclusion..."

Licensing

License Validation

The license system includes the following security features:

• Machine Fingerprinting — Each license is tied to a specific machine's hardware fingerprint
• Online Validation — Licenses are validated against our auth server on startup
• Offline Grace Period — 7-day cached validation for intermittent connectivity
• Seat Management — Configure how many machines can use a single license key
• Instant Revocation — Compromised keys can be revoked from the admin panel

Environment Variables

Examples

Converting a README to PDF

Take this README content and convert it to a professional PDF:

# My Project

A brief description of the project.

## Installation

\`\`\`bash
npm install my-project
\`\`\`

## Usage

\`\`\`javascript
import { feature } from 'my-project';
feature.doSomething();
\`\`\`

Use the minimal theme for a clean look.

Comparing Themes

Show me previews of this content in different themes so I can choose:

# Meeting Notes
## Action Items
- [ ] Review pull requests
- [ ] Update documentation
- [ ] Schedule follow-up

First show me the corporate theme, then the neon theme.

Batch Documentation Export

I need to export our documentation chapters as separate PDFs:

1. Getting Started Guide (content...)
2. API Reference (content...)
3. Troubleshooting (content...)

Convert all three to PDF with consistent styling using the corporate theme.