Mcp Prompt Manager
About
Git-driven MCP Server for managing Prompt templates with Handlebars support. Store prompts in Git, sync automatically, and use dynamic templates in Cursor, Claude Desktop, and other MCP clients. Features hot-reload, group filtering, version management, and Docker/Kubernetes deplo
Explore
- Git-driven synchronization from single or multiple repositories
- Handlebars template engine with partials, variables, and conditionals
- Hot reload and live sync without server restart
- Group filtering to load only needed prompt groups
- LRU cache with TTL, statistics, and optional Redis provider
- Docker and Kubernetes deployment with health monitoring
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Prompt ManagerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js >= 18.0.0
- pnpm >= 8.0.0 (or npm/yarn)
- Git repository with your prompts (or local path)
If you're installing from this marketplace, follow the marketplace's installation instructions. After installation, configure your MCP client.
cp .env.docker.example .env
git clone https://github.com/CarlLee1983/mcp-prompt-manager.git
cd mcp-prompt-manager
pnpm install
cp .env.example .env
Deploy with Docker or Kubernetes. Production-ready configurations with health checks, monitoring, and logging.
Configure cache behavior:
``bash`
CACHE_PROVIDER=local
CACHE_MAX_SIZE=2000
CACHE_TTL=7200000
CACHE_CLEANUP_INTERVAL=30000
json
{
"mcpServers": {
"mcp-prompt-manager": {
"command": "node",
"args": ["/path/to/mcp-prompt-manager/dist/index.js"],
"env": {
"PROMPT_REPO_URL": "https://github.com/yourusername/your-prompts-repo.git",
"MCP_LANGUAGE": "en",
"MCP_GROUPS": "common",
"LOG_LEVEL": "info"
}
}
}
}
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| PROMPT_REPO_URL | Yes | - | Git repository URL or local path |PROMPT_REPO_URLS
| | No | - | Multiple repository URLs (comma-separated) |MCP_LANGUAGE
| | No | en | Output language (en or zh) |MCP_GROUPS
| | No | - | Prompt groups to load (comma-separated) |STORAGE_DIR
| | No | .prompts_cache | Local cache directory |GIT_BRANCH
| | No | main | Git branch to sync |LOG_LEVEL
| | No | warn | Logging level |CACHE_PROVIDER
| | No | local | Cache provider (local or redis) |CACHE_MAX_SIZE
| | No | 1000 | Maximum cache size |CACHE_TTL
| | No | 3600000 | Cache TTL (milliseconds) |PROMPT_REPO_URLS` is not set
Required if
---
Version: v1.1.0
Last Updated: 2025-01-06
mcp_reload
/ `mcp_reload_prompts` - Hot-reload all prompts
mcp_stats
/ `mcp_prompt_stats` - Get prompt statistics
mcp_list
/ `mcp_prompt_list` - List all prompts with filtering
mcp_inspect
Inspect detailed information for a specific prompt
mcp_repo_switch
Switch to a different prompt repository
preview_prompt
Preview/render prompt templates (debug utility)
- mcp_reload / mcp_reload_prompts - Hot-reload all prompts
- mcp_stats / mcp_prompt_stats - Get prompt statistics
- mcp_list / mcp_prompt_list - List all prompts with filtering
- mcp_inspect - Inspect detailed information for a specific prompt
- mcp_repo_switch - Switch to a different prompt repository
- preview_prompt - Preview/render prompt templates (debug utility)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp prompt manager": {
"mcp-prompt-manager": {
"command": "node",
"args": [
"/absolute/path/to/mcp-prompt-manager/dist/index.js"
],
"env": {
"PROMPT_REPO_URL": "https://github.com/yourusername/your-prompts-repo.git",
"MCP_LANGUAGE": "en",
"MCP_GROUPS": "common",
"LOG_LEVEL": "info"
}
}
}
}
}McpServers
{
"mcp-prompt-manager": {
"command": "node",
"args": [
"/absolute/path/to/mcp-prompt-manager/dist/index.js"
],
"env": {
"PROMPT_REPO_URL": "https://github.com/yourusername/your-prompts-repo.git",
"MCP_LANGUAGE": "en",
"MCP_GROUPS": "common",
"LOG_LEVEL": "info"
}
}
}✨ Key Features
🔄 Git-Driven Synchronization
- Automatic synchronization from Git repositories - Support for multiple repository URLs - System repository for common prompts - Watch mode with automatic change detection🎯 Dynamic Templates
- Handlebars Template Engine: Create powerful, reusable prompts with Handlebars syntax - Partials Support: Split and reuse prompt fragments (e.g., role settings, output formats) - Variables & Conditionals: Dynamic content based on context🚀 Zero-Downtime Updates
- Hot Reload: Update prompts without restarting the server - Live Sync: Automatic detection of Git and file changes - Version Management: Built-in prompt versioning and state tracking📊 Smart Management
- Group Filtering: Load only the prompts you need - Cache System: LRU eviction with TTL support and statistics - Error Handling: Comprehensive error reporting and statistics - Health Monitoring: System health status and prompt statistics🐳 Production Ready
- Docker Support: Multi-stage builds with production configurations - Kubernetes: Helm chart for easy deployment - Type Safe: Full TypeScript with Zod validation - 87%+ Test Coverage: 463+ tests with comprehensive CI/CD🚀 Quick Start
Prerequisites
- Node.js >= 18.0.0 - pnpm >= 8.0.0 (or npm/yarn) - Git repository with your prompts (or local path)Installation
Option 1: Marketplace Installation (Easiest)
If you're installing from this marketplace, follow the marketplace's installation instructions. After installation, configure your MCP client.Option 2: Docker Deployment (Recommended)
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
