mdt_mcp

MCP server for mdt (manage markdown templates)

mdt_mcp is a Model Context Protocol (MCP) server for the mdt template engine. It exposes mdt functionality as MCP tools that can be used by AI assistants and other MCP-compatible clients.

Tools

• mdt_check — Verify all consumer blocks are up-to-date.
• mdt_update — Update all consumer blocks with latest provider content.
• mdt_list — List all providers and consumers in the project.
• mdt_find_reuse — Find similar providers and where they are already consumed in markdown and source files to encourage reuse.
• mdt_get_block — Get the content of a specific block by name.
• mdt_preview — Preview the result of applying transformers to a block.
• mdt_init — Initialize a new mdt project with a sample template file.

Agent Workflow

• Prefer reuse before creation: call mdt_find_reuse (or mdt_list) before introducing a new provider block.
• Keep provider names global and unique in the project to avoid collisions.
• After edits, run mdt_check (and optionally mdt_update) so consumer blocks stay synchronized.

Usage

Start the MCP server via the CLI:

mdt mcp

Add the following to your MCP client configuration:

{
	"mcpServers": {
		"mdt": {
			"command": "mdt",
			"args": ["mcp"]
		}
	}
}

Installation

[dependencies]
mdt_mcp = "0.7.0"