Markdown-to-HTML

You run a Markdown-to-HTML MCP server that accepts remote HTTP calls or local stdio interactions, enabling you to convert Markdown content into HTML from any MCP-compatible client, including Cursor or curl-based workflows. This server is designed to be easy to start, flexible across environments, and type-safe for reliable integration.

How to use

You can invoke the Markdown-to-HTML MCP server in two main ways: remotely over HTTP or locally via stdio. Remote HTTP lets you call the service from any machine on your network or in the cloud by posting a request to the MCP endpoint. Local stdio lets you run the server inside your development environment or scripts and call it directly through standard input/output.

How to install

Prerequisites you need on your machine: a modern Node.js runtime (preferably a recent LTS version) and npm. Ensure you have network access to install dependencies.

npm install

# Build artifacts (if you plan to run a built HTTP server)
npm run build

Additional sections

You can start the server in local stdio mode or expose an HTTP interface for remote usage.

# Local stdio startup
npx ts-node src/cli.ts

# Alternative local start via npm script (if provided)
npm run start

MCP configuration examples

The following MCP connections enable both local and remote usage. The HTTP configuration is shown first, followed by a local stdio configuration.

{
  "mcpServers": {
    "md2html_mcp": {
      "type": "http",
      "name": "md2html_mcp",
      "url": "http://localhost:3000/mcp",
      "args": []
    }
  }
}

Local stdio configuration example

If you want to run everything locally and call it via stdio, use the following command configuration.

{
  "mcpServers": {
    "md2html_mcp": {
      "type": "stdio",
      "name": "md2html_mcp",
      "command": "npx",
      "args": ["ts-node", "src/cli.ts"]
    }
  }
}

Cursor integration notes

You can integrate this MCP server into Cursor either for local development (stdio) or remote usage (http). Configure Cursor to use the appropriate MCP channel, then perform Markdown-to-HTML conversions directly from the Cursor tool panel.

Troubleshooting and tips

If you encounter type or module resolution issues when running TypeScript code directly, ensure you are using the ES module loader for ts-node with TypeScript files. If you run the built JavaScript version, use the CommonJS build and avoid ES module-only configurations.

Available tools

markdownToHtml

Converts Markdown input into HTML output, enabling integration with MCP clients through HTTP or stdio transports.