Promptopia Mcp

What is Promptopia Mcp?

Promptopia Mcp is a Model Context Protocol (MCP) server for managing, organizing, and reusing prompt templates with variable substitution and multi‑message conversation structures. It provides persistent filesystem storage for both single‑content prompts and multi‑message conversation templates, with automatic variable detection and substitution. Built with TypeScript, it integrates natively with MCP‑compatible AI clients like Claude Desktop.

How to use Promptopia Mcp?

Install automatically via Smithery using npx -y @smithery/cli install @lumile/promptopia-mcp --client claude, or manually by adding a configuration entry to your Claude Desktop config file. The PROMPTS_DIR environment variable must be set to a directory for storing prompts. Alternatively, clone the repository, run npm install and npm run build, then point the MCP server to the built index.js. Debugging is supported via the MCP Inspector (npm run inspector).

Key features of Promptopia Mcp

• Create, retrieve, update, and delete prompt templates with full CRUD
• Support single‑content and role‑based multi‑message conversation templates
• Automatic detection and substitution of {{variable}} placeholders
• Native MCP protocol integration for resources and tools
• Filesystem persistence using JSON files
• Mixed content types (text and image) in multi‑message templates
• Full TypeScript implementation with type safety and error handling

Use cases of Promptopia Mcp

• Centralizing and versioning prompt templates across multiple projects
• Building reusable multi‑turn conversation structures for AI assistants
• Dynamically substituting variables in prompts for different contexts
• Managing a personal library of prompts accessible via Claude Desktop

FAQ from Promptopia Mcp

What runtime does Promptopia Mcp require?

Promptopia Mcp requires Node.js (installed via npm) and an MCP‑compatible client (e.g., Claude Desktop). You must set the PROMPTS_DIR environment variable to a writable directory.

How does variable substitution work?

Variables are detected using {{variable}} syntax in prompt content. At runtime, you can apply value substitutions to replace these placeholders with actual values before the prompt is used.

Where are prompt templates stored?

All prompts are persisted on the filesystem as JSON files in the directory specified by the PROMPTS_DIR environment variable. No external database is needed.

Can I use Promptopia Mcp with Claude Desktop?

Yes. Example configurations for both NPX and local installations are provided in the README. The server exposes prompts as native MCP resources that Claude Desktop can access.

What advanced capabilities are planned?

Future features include conditional logic, version control with rollback, search and tagging, and import/export of prompt collections.