Skip to main content
Glama
engrtipusultan

mcp-local-prompt-server

by engrtipusultan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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

MCP Inspector showing the registered prompts available from the server

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

File

Prompt name

Description

grammer_correction_agent.md

grammer correction agent

Fixes English grammar errors with minimal changes, preserving the user's original style

parapharasing_agent.md

parapharasing agent

Paraphrases text with configurable tone (professional, casual, etc.) and length adjustments

prompt_enhancement_agent.md

prompt enhancement agent

Refines user inputs into structured, actionable prompts

summerization_agent.md

summerization agent

Summarizes and structurally maps long texts with metadata, TL;DR, and hierarchical outlines

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

Script

Command

Description

npm run dev

tsx server.ts

Run the server

npm start

tsx server.ts

Run the server (alias)

License

Apache 2.0

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Prompts MCP Server

    tanker327
    A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol server for managing prompt templates as markdown files with YAML frontmatter, allowing users and LLMs to easily add, retrieve, and manage prompts.
    5
    8 npm
    16
    MIT

  • mcp-prompt-engine

    vasayxtx
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for managing and serving dynamic prompt templates using elegant and powerful text template engine. Create reusable, logic-driven prompts with variables, partials, and conditionals that can be served to any compatible MCP client like Claude Code, Claude Desktop, Gemini CLI, etc.
    18
    MIT

  • dev-prompt-mcp

    sayll
    A
    license
    B
    quality
    D
    maintenance
    An MCP server that registers customizable prompt templates as tools for natural language interaction. It supports hot-reloading and easy extension via YAML or JSON files to automate tasks like code review, refactoring, and content summarization.
    2
    8 npm
    1
    MIT

  • Prompt Registry MCP

    stevengonsalvez
    A
    license
    Not graded
    quality
    C
    maintenance
    A lightweight, file-based server for managing and serving personal prompt templates with variable substitution support via the Model Context Protocol. It allows users to store, update, and organize prompts in a local directory through integrated MCP tools and CLI assistants.
    5 npm
    7
    MIT