Skip to main content
Glama
hsiangjenli

MCP Markdown Template

by hsiangjenli
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

šŸš€ 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:

  1. Load - Fetch templates from local files, directories, or URLs

  2. Parse - Extract <variables> and metadata from YAML frontmatter

  3. Generate - Create typed FastAPI endpoints with Pydantic models

  4. 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

šŸ“š Documentation

Build docs locally:

scripts/build_docs.sh && uv run mkdocs build

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hsiangjenli/mcp-markdown-template'

If you have feedback or need assistance with the MCP directory API, please join our Discord server