MDX

Provides an MCP server for MDX reading, searching, conversion, and metadata extraction.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 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": {
    "llmtooling-mdx-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/mdx-mcp-server/dist/index.js"
      ],
      "env": {
        "WORKSPACE_ROOT": "/path/to/your/workspace"
      }
    }
  }
}

MDX MCP Server lets you connect language models to MDX files for reading, searching, converting, and extracting metadata, all with cross‑platform support and secure path handling.

How to use

You interact with the MDX MCP Server through an MCP client to read MDX files as Markdown, perform contextual searches, convert MDX to Markdown on disk, and retrieve YAML frontmatter. Use the available tools to shape responses, extract content, and manage file metadata within your workspace.

How to install

node --version

npm install
npm run build

Configuration and usage notes

Configure the MCP server in your settings to expose the MDX processing capabilities. The MDX MCP Server runs as a local process and is referenced by your MCP configuration so your client can invoke its tools.

{
  "mcpServers": {
    "mdx": {
      "command": "node",
      "args": ["/absolute/path/to/mdx-mcp-server/dist/index.js"],
      "env": {
        "WORKSPACE_ROOT": "/path/to/your/workspace"
      }
    }
  }
}

Development

# Clone the repository
git clone https://github.com/LLMTooling/mdx-mcp-server.git
cd mdx-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

Available tools

read_mdx

Read an MDX file and return its contents as Markdown.

search_mdx

Search for content within an MDX file with surrounding context.

convert_mdx_to_md

Convert an MDX file to a Markdown file on disk.

get_mdx_frontmatter

Extract YAML frontmatter from an MDX file.