io.github.MDMagic-MCP/mdmagic-mcp-server MCP Server

Name: io.github.MDMagic-MCP/mdmagic-mcp-server MCP Server
Author: io.github.MDMagic-MCP

io.github.MDMagic-MCP/mdmagic-mcp-server

Repository Registry

What is the io.github.MDMagic-MCP/mdmagic-mcp-server MCP server?

Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.

How to install io.github.MDMagic-MCP/mdmagic-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MDMAGIC_API_KEY
required
secret
Your personal MDMagic API key (format: mdmagic-XXXXXXXXXXXXXXXX). Get yours at https://mdmagic.ai/account — the 'Connect to AI Assistants via MCP' card on your account page generates the key and pre-fills a copy-pasteable config block.
MDMAGIC_BASE_URL
Override the MDMagic API base URL. Defaults to https://api.mdmagic.ai. Only set this if you're running MDMagic against a local dev backend.
REQUEST_TIMEOUT
Request timeout in milliseconds. Increase for very large documents on slow connections. Default: 30000 (30s).
MCP_TRANSPORT
Transport mode: 'stdio' (default, for local clients like Claude Desktop) or 'http' (for self-hosted Streamable HTTP).
MCP_HTTP_PORT
Port for HTTP transport mode. Default: 3001. Only used when MCP_TRANSPORT=http.
MCP_HTTP_HOST
Bind address for HTTP transport mode. Default: 127.0.0.1. Only used when MCP_TRANSPORT=http.
x-api-key
required
secret
Your personal MDMagic API key from https://mdmagic.ai/account

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mdmagic-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mdmagic/mcp-server"
      ],
      "env": {
        "MDMAGIC_API_KEY": "<YOUR_MDMAGIC_API_KEY>",
        "MDMAGIC_BASE_URL": "<YOUR_MDMAGIC_BASE_URL>",
        "REQUEST_TIMEOUT": "<YOUR_REQUEST_TIMEOUT>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "x-api-key": "<YOUR_X_API_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mdmagic-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mdmagic/mcp-server"
      ],
      "env": {
        "MDMAGIC_API_KEY": "<YOUR_MDMAGIC_API_KEY>",
        "MDMAGIC_BASE_URL": "<YOUR_MDMAGIC_BASE_URL>",
        "REQUEST_TIMEOUT": "<YOUR_REQUEST_TIMEOUT>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "x-api-key": "<YOUR_X_API_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mdmagic-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mdmagic/mcp-server"
      ],
      "env": {
        "MDMAGIC_API_KEY": "<YOUR_MDMAGIC_API_KEY>",
        "MDMAGIC_BASE_URL": "<YOUR_MDMAGIC_BASE_URL>",
        "REQUEST_TIMEOUT": "<YOUR_REQUEST_TIMEOUT>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "x-api-key": "<YOUR_X_API_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mdmagic-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mdmagic/mcp-server"
      ],
      "env": {
        "MDMAGIC_API_KEY": "<YOUR_MDMAGIC_API_KEY>",
        "MDMAGIC_BASE_URL": "<YOUR_MDMAGIC_BASE_URL>",
        "REQUEST_TIMEOUT": "<YOUR_REQUEST_TIMEOUT>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "x-api-key": "<YOUR_X_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add mdmagic-mcp-server --env MDMAGIC_API_KEY=<YOUR_MDMAGIC_API_KEY> --env MDMAGIC_BASE_URL=<YOUR_MDMAGIC_BASE_URL> --env REQUEST_TIMEOUT=<YOUR_REQUEST_TIMEOUT> --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env MCP_HTTP_PORT=<YOUR_MCP_HTTP_PORT> --env MCP_HTTP_HOST=<YOUR_MCP_HTTP_HOST> --env x-api-key=<YOUR_X_API_KEY> -- npx -y @mdmagic/mcp-server