mdMCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mdMCP
Turn a Markdown file into a local MCP server, with zero dependencies.
pip install markdown-mcp-serverQuickstart
1. Write a tool file:
## Tool: health_check
Check if a URL is reachable.
### Parameters
- url (string, required): URL to check
### Execute
\```bash
STATUS=$(curl -sf -o /dev/null -w '%{http_code}' -m 5 "$MDMCP_URL")
echo "HTTP $STATUS"
\```2. Serve it:
mdmcp serve tools.md3. Connect to Claude Code:
{
"mcpServers": {
"my-tools": {
"command": "mdmcp",
"args": ["serve", "tools.md"]
}
}
}That's it. Your Markdown is now an MCP server.
Related MCP server: mcp-markdown-tools
How it works
## Tool: namedefines a tool### Parametersdefines input schema (envvar-based, no string interpolation)### Executecontains a bash script inside a fenced code blockParameters are passed as
$MDMCP_<NAME>environment variables
Commands
mdmcp list tools.md # List available tools
mdmcp validate tools.md # Validate tool definitions
mdmcp run tools.md tool_name '{}' # Run a tool once
mdmcp serve tools.md # Start MCP stdio serverSecurity
Minimal env: only PATH, HOME, USER, SHELL, LANG, TERM are inherited. API keys and tokens are NOT exposed to tool scripts.
No string interpolation: parameters are passed as environment variables, not injected into shell code.
Required param validation: missing required parameters return an error before execution.
Timeout + process cleanup: 30s timeout with process group kill to prevent zombies.
Tips
Always quote
"$MDMCP_VAR"in bash to prevent word splittingUse
${MDMCP_VAR:-default}for optional params with bash-side defaultsYou can use
python3 -cinside bash for complex logic (seeexamples/data-tools.md)Use
set -euat the top of scripts for safer execution
Examples
See the examples/ directory:
ops-tools.md — disk usage, port check, git log, docker status, health check
dev-tools.md — find TODOs, run linter, check port (from Codex dogfood)
data-tools.md — CSV summary, JSON inspect, file diff (from Gemini dogfood)
Known limitations
Execute blocks only support
```fences (not~~~)Parameter names must be
\w+(no spaces or special chars)Nested
```inside heredocs will confuse the parserAll parameter values are strings in bash; cast manually if needed
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Share markdown as a link anyone can comment on and edit, no account. MCP server and CLI.
Build your own tools from chat: design, test and host them on a shareable MCP server URL.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for markdown files — search, extract sections, list headings, find code blocks across docs.678 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides tools for analyzing, linting, formatting, and generating Markdown content. It enables users to programmatically manage Markdown files through features like table of contents generation, statistics calculation, and JSON-to-table conversion.52 npm1MIT
- AlicenseNot gradedqualityDmaintenanceLightweight MCP server for providing user prompts defined in Markdown with argument support.6BSD 3-Clause
- AlicenseBqualityDmaintenanceA universal MCP server that loads Markdown skills from arbitrary folders, enabling lazy discovery and execution of skills across multiple MCP-capable tools.529 npm2MIT