prompts-mcp

masaki39/prompts-mcp

3.2

If you are the rightful owner of prompts-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The model context protocol server transforms Markdown files into callable MCP tools, allowing for custom prompts.

prompts-mcp

NPM Downloads

Simple MCP server that turns Markdown files into mcp tools, providing cutrom prompts. Point it at a directory and every .md inside becomes a callable prompt.

Prompt format

Each Markdown file is parsed once at startup. The file name becomes the tool name and the YAML frontmatter controls metadata:

---
title: Write A Brief
description: Produce a concise project brief.
enabled: true # set to false to skip registering this prompt
---
Prompt body goes here...
  • title – optional display label (falls back to file name)
  • description – optional tool description (defaults to “Prompt defined in …”)
  • enabled – defaults to true; set to false to keep the prompt out of MCP entirely

MCP config example

Add the server to your MCP client (Claude Desktop, VS Code Copilot MCP, etc.) with a config entry like:

{
  "mcpServers": {
    "prompts-mcp": {
      "command": "npx",
      "args": ["-y", "@masaki39/prompts-mcp"],
      "env": {
        "PROMPTS_DIR": "/absolute/path/to/prompts"
      }
    }
  }
}

Update the paths to match your system. The server communicates over stdio, so no additional ports are needed.