Doc Converter

Provides document format conversion between .docx and Markdown using an npx-based MCP server with an API key.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nextdoorlaohuang-hf-consistent_docx_mcp": {
      "command": "npx",
      "args": [
        "consistent-docx-mcp",
        "--api-key",
        "YOUR-API-KEY-HERE"
      ],
      "env": {
        "API_KEY": "YOUR-API-KEY-HERE"
      }
    }
  }
}

This MCP server provides a ready-to-use toolset for converting between .docx and Markdown formats, enabling you to keep document formatting consistent when working with large language models. It runs via npx, so you can deploy and use it directly from your MCP client without manual installation.

How to use

You can enable document conversions from your MCP client by wiring this server as an MCP endpoint. Use the provided stdio configuration to run the converter locally through npx, then call the available tools to transform between .docx and Markdown as needed.

How to install

Prerequisites you need on your host: Node.js and npm, so you can run npx commands directly from your MCP client configuration.

Ensure Node.js and npm are installed on your system. Check with node -v and npm -v.
No local installation is required for usage—this MCP is designed to run via npx on demand.
Add the MCP server configuration to your client so it can launch via npx with your API key.

Configuration and usage notes

The MCP server exposes two core tools you can call through your client after it is configured: docx_to_markdown and markdown_to_docx. These tools operate as follows.

docx_to_markdown reads a local .docx file and returns the extracted text as Markdown. You provide the absolute path to the .docx file via the path parameter.
markdown_to_docx takes Markdown content and a reference .docx file to guide styling, producing a new .docx document at the specified outputPath. You supply markdown, referencePath, and outputPath.

Examples

This section shows how you can configure the MCP client to run via npx and provide your API key. The key must be kept secure and not shared publicly.

Limitations and security considerations

Only run this converter in trusted environments and protect your API key. Never expose the API key in client-side code or publicly readable configurations.

Available tools

docx_to_markdown

Convert a local .docx file to plain text in Markdown by providing the absolute path to the .docx file.

markdown_to_docx

Generate a new .docx file from Markdown content using a reference .docx file as a styling template; specify the Markdown text, the template path, and the output path.