MCP Prompts

v1.0.0Knowledge & Memorystable

Enables creation, management, and templating of prompts through a simplified SOLID architecture, allowing users to organize prompts by category and fill in templates at runtime.

mcp-prompts-servermcpai-integration
Share:
114
Stars
0
Downloads
0
Weekly
0/5

What is MCP Prompts?

MCP Prompts is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables creation, management, and templating of prompts through a simplified solid architecture, allowing users to organize prompts by category and fill in templates at runtime.

Enables creation, management, and templating of prompts through a simplified SOLID architecture, allowing users to organize prompts by category and fill in templates at runtime.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables creation, management, and templating of prompts thro

Use Cases

Create, manage, and template prompts with simplified architecture.
Organize prompts by category and fill in templates at runtime.
sparesparrow

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-prompts-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Prompts

MCP Prompts Server is a TypeScript-based MCP server that provides a complete prompt management system for AI workflows, supporting creation, retrieval, updating, and deletion of reusable prompts through a clean SOLID architecture. It handles prompt templating with {{variableName}} syntax for runtime variable substitution, organizes prompts by category and tags, and supports multiple storage backends including in-memory, filesystem, and AWS (DynamoDB, S3, SQS). Teams use it to maintain a shared library of tested prompt templates that AI assistants can retrieve and apply consistently across different tasks and workflows.

Prerequisites

  • Node.js 18 or later
  • npm, pnpm, or yarn for installation
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • Optional: AWS account with DynamoDB and S3 if using the aws storage backend
  • Optional: Stripe account if payment-gated prompt access is needed
1

Install the package

Install the @sparesparrow/mcp-prompts package globally or use it via npx. The scoped package name is required.

npm install -g @sparesparrow/mcp-prompts
# or run directly without installing:
npx -y @sparesparrow/mcp-prompts
2

Choose a storage backend

Set the STORAGE_TYPE environment variable to select where prompts are persisted. Use 'memory' for ephemeral in-process storage, 'file' for local filesystem storage, or 'aws' for DynamoDB/S3.

export STORAGE_TYPE=file
export MODE=mcp
3

Configure AWS storage (optional)

If using STORAGE_TYPE=aws, provide these additional environment variables for DynamoDB and S3 access.

export AWS_REGION=us-east-1
export AWS_ACCESS_KEY_ID=your_key_id
export AWS_SECRET_ACCESS_KEY=your_secret
export PROMPTS_TABLE=my-prompts-table
export PROMPTS_BUCKET=my-prompts-bucket
4

Add the server to your MCP client

Add the following configuration to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS.

{
  "mcpServers": {
    "mcp-prompts": {
      "command": "npx",
      "args": ["-y", "@sparesparrow/mcp-prompts"],
      "env": {
        "MODE": "mcp",
        "STORAGE_TYPE": "file"
      }
    }
  }
}
5

Restart Claude Desktop and verify

Restart Claude Desktop. The MCP Prompts server will appear in the connected servers list. You can verify by asking Claude to list available prompts.

MCP Prompts Examples

Client configuration for Claude Desktop

Minimal configuration using file-based storage for prompt persistence across sessions.

{
  "mcpServers": {
    "mcp-prompts": {
      "command": "npx",
      "args": ["-y", "@sparesparrow/mcp-prompts"],
      "env": {
        "MODE": "mcp",
        "STORAGE_TYPE": "file",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Prompts to try

Use these prompts after connecting the server to manage your prompt library.

- "List all prompts in the development category"
- "Create a new prompt called 'Code Review' with template: Review this {{language}} code for {{criteria}}"
- "Apply the code review template with language=Python and criteria=security vulnerabilities"
- "Show me all prompts tagged with 'documentation'"
- "Get usage statistics for the prompt library"

Troubleshooting MCP Prompts

Server starts but prompts are lost between sessions

Set STORAGE_TYPE=file instead of STORAGE_TYPE=memory. File storage persists prompts to disk. Optionally set a custom storage path using the PROMPTS_DIR environment variable.

Template variable substitution returns the raw {{variableName}} text

Use the apply_template tool explicitly and pass a JSON object with the variable values. The syntax uses double curly braces: {{variableName}}. Ensure variable names in the template exactly match the keys in your substitution object.

AWS storage fails with credential errors

Confirm AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION are all set and valid. The IAM user needs read/write permissions on the specific DynamoDB tables (PROMPTS_TABLE, USERS_TABLE) and S3 bucket (PROMPTS_BUCKET) configured.

Frequently Asked Questions about MCP Prompts

What is MCP Prompts?

MCP Prompts is a Model Context Protocol (MCP) server that enables creation, management, and templating of prompts through a simplified solid architecture, allowing users to organize prompts by category and fill in templates at runtime. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Prompts?

Follow the installation instructions on the MCP Prompts GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Prompts?

MCP Prompts works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Prompts free to use?

Yes, MCP Prompts is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-prompts-server": { "command": "npx", "args": ["-y", "mcp-prompts-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Prompts?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides