Which integrations are available for this server?

Supports loading and processing [GitHub](/mcp/servers/integrations/github) templates, including GitHub Issue templates, from repositories via raw URLs. Transforms [markdown](/mcp/servers/integrations/markdown) templates (like GitHub Issue templates) into MCP tools automatically, extracting variables and rendering content with support for YAML frontmatter metadata.

MCP Markdown Template by hsiangjenli

🚀 Core Idea

Transform markdown templates (like GitHub Issue templates) into MCP tools automatically. Write a template once, get both a FastAPI endpoint and an MCP tool.

🏗️ Architecture

mcp_tools/ ├── models.py # Data models (Template, TemplateVariable) ├── loader.py # Load templates from files, directories, URLs ├── parser.py # Extract variables & render with Jinja2 ├── generator.py # Create FastAPI endpoints dynamically └── server.py # FastMCP server with CORS

How it works:

Load - Fetch templates from local files, directories, or URLs
Parse - Extract <variables> and metadata from YAML frontmatter
Generate - Create typed FastAPI endpoints with Pydantic models
Serve - Expose as both REST API (/api/docs) and MCP tools (/mcp)

🌟 Features

Auto-generate MCP tools from markdown templates
Multiple sources - Load from local files, directories, or URLs
Swagger UI - Test endpoints at /api/docs
Docker ready - Production-ready container setup
CI/CD - GitHub Actions for automated workflows

🛠️ Getting Started

Local Development

Install dependencies:

uv sync

Run the MCP server:

uv run uvicorn mcp_tools.main:starlette_app --host 127.0.0.1 --port 8000

Docker

Build the Docker image:

docker build -t docker.io/username/mcp-markdown-template:latest .

Run the container with various template sources:

# Mount local templates directory docker run -i --rm -p 8000:8000 \ -v /path/to/your/templates:/app/templates \ -e MCP_TEMPLATES_SOURCE=/app/templates \ docker.io/hsiangjenli/mcp-markdown-template:latest

# Load from URL (GitHub raw URL) docker run -i --rm -p 8000:8000 \ -e MCP_TEMPLATES_SOURCE=https://raw.githubusercontent.com/hsiangjenli/mcp-markdown-template/refs/heads/main/.github/ISSUE_TEMPLATE/demo.md \ docker.io/hsiangjenli/mcp-markdown-template:latest

# Multiple sources (comma-separated) docker run -i --rm -p 8000:8000 \ -e MCP_TEMPLATES_SOURCE="/app/templates,https://raw.githubusercontent.com/owner/repo/main/template.md" \ -v /path/to/local/templates:/app/templates \ docker.io/hsiangjenli/mcp-markdown-template:latest

MCP Server configuration (for Claude Desktop, etc.):

{ "servers": { "markdown-template": { "url": "http://localhost:8000/mcp", "type": "http" } }, "inputs": [] }

Template Sources

Format	Example
Local directory	`/path/to/templates/`
Local file	`/path/to/template.md`
URL	`https://raw.githubusercontent.com/.../template.md`
Multiple	`source1,source2` (comma-separated)

Environment Variables

Variable	Default
`MCP_TITLE`	`Python MCP Template`
`MCP_DESCRIPTION`	`A template for creating MCP-compliant FastAPI`
`MCP_TEMPLATES_SOURCE`	`.github/ISSUE_TEMPLATE`