mcp-local-prompt-server

An MCP server that dynamically registers prompt templates from local files and serves them to clients with the assistant role (not user).

Features

• File-based prompts — Drop .txt, .md, .yaml, .yml, or .json files into prompts/ and they are registered automatically on startup

• Clean naming — Filenames like grammer_correction_agent.md become prompt names like "grammer correction agent"

• Assistant role delivery — Prompts are served with role: "assistant", so clients treat the content as system-level guidance, not user input

• Stdio transport — Connects via standard input/output, compatible with any MCP host

Related MCP server: mcp-prompt-engine

Example

The screenshot shows the MCP Inspector listing all 4 prompts after the server starts.

Prerequisites

• Node.js 18+

• npm

Installation

git clone git@github.com:engrtipusultan/mcp-local-prompt-server.git
cd mcp-local-prompt-server
npm install

Included prompts

Adding more prompts

Create a file in the prompts/ directory:

prompts/
├── code_review_agent.md
├── sql_optimizer.txt
└── writing_feedback.yaml

Supported extensions: .txt, .md, .yaml, .yml, .json. Hyphens and underscores in filenames are converted to spaces for the prompt name. No code changes needed — prompts are registered automatically on the next server start.

Usage

Run

npm run dev

or

npm start

Both run the server directly via tsx — no build step needed.

Testing with MCP Inspector

npx @modelcontextprotocol/inspector npm run dev

This opens a web UI where you can browse registered prompts and invoke them interactively.

How it works

On startup, the server scans the prompts/ directory for supported files. Each file is registered as an MCP prompt using mcpServer.registerPrompt(). When a client requests a prompt, the server reads the file content and returns it as an assistant-role message.

┌─────────────────────────────────────┐
│         MCP Host (client)           │
│            stdio transport          │
└────────────┬────────────────────────┘
             │ JSON-RPC
             ▼
┌─────────────────────────────────────┐
│  mcp-local-prompt-server            │
│                                     │
│  ┌────────────────────────────────┐ │
│  │  prompts/                      │ │
│  │  ├── grammer_correction.md     │ │
│  │  ├── summarization_agent.md    │ │
│  │  └── ...                       │ │
│  └────────────────────────────────┘ │
└─────────────────────────────────────┘

Scripts reference

License

Apache 2.0