Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Simple Prompts

FreeNot checked

A simple MCP server for utilizing prompts defined in YAML files.

GitHubEmbed

About

A simple MCP server for utilizing prompts defined in YAML files.

README

Overview

日本語はこちら

  • A simple MCP server for utilizing prompts.
  • Prompts are defined in advance using YAML files.

Defining Prompt Files

Define each prompt in a separate YAML file.

Schema Details

  • name: string. Identifier for the prompt.
  • description: string. Description of the prompt.
  • arguments: array. Each element is an object with the following properties:
    • name: string. Argument name.
    • description: string. Description of the argument.
    • required: boolean. Whether the argument is required.
  • prompt: string. The main body of the prompt.
    The prompt body (prompt) is dynamically generated using Python's str.format() with named arguments.
    As shown in the example, you can use placeholders like {user_name} which will be replaced with the provided argument values.

Example

name: example
description: This is a sample prompt.
arguments:
  - name: user_name
    description: Name of the user
    required: true
prompt: |
  Hello, {user_name}!

Please create each YAML file according to this schema.

Registering the MCP Server

To register simple-prompts-mcp as an MCP server, add the following to your configuration file.

Note:
Please use Python 3.11 or later with uv.

{
    "mcpServers": {
        "simple-prompts-mcp": {
            "command": "uvx",
            "args": ["simple-prompts-mcp"]
        }
    }
}

Configuration

Environment Variable Purpose Default Value
PROMPTS_DIR Directory to store prompt files ~/.config/simple-prompts-mcp
{
    "mcpServers": {
        "simple-prompts-mcp": {
            "command": "uvx",
            "args": ["simple-prompts-mcp"],
            "env": {
                "PROMPTS_DIR": "/full-path/to/prompts/dir"
            }
        }
    }
}

License

This project is licensed under the MIT License. See the LICENSE file for details.

from github.com/sinofseven/simple-prompts-mcp

Install Simple Prompts in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install simple-prompts-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add simple-prompts-mcp -- uvx simple-prompts-mcp

FAQ

Is Simple Prompts MCP free?

Yes, Simple Prompts MCP is free — one-click install via Unyly at no cost.

Does Simple Prompts need an API key?

No, Simple Prompts runs without API keys or environment variables.

Is Simple Prompts hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Simple Prompts in Claude Desktop, Claude Code or Cursor?

Open Simple Prompts on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Simple Prompts with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs