prompts-mcp

Model Context Protocol (MCP) server of Markdown based prompts.

Serves a directory of Markdown files as prompts to a chat session.

Works with any MCP client supporting server-side prompts.

Usage

Configure your client (e.g. Claude Desktop) by adding to your mcp.json:

{
    "mcpServers": {
        "prompts": {
            "command": "uvx",
            "args": ["prompts-mcp"],
            "env": {
                "PROMPTS_DIR": "/path/to/your/prompts"
            }
        }
    }
}

The location of the mcp.json file depends on your client and operating system.

Configuration

Set PROMPTS_DIR to a path containing the .md files you want to serve as prompts.

⚠️: The server will exit with an error if PROMPTS_DIR is not set or if the directory does not exist.

Prompt naming: _'s in file names are converted to spaces and .md is dropped.

Development

About 100% coded by AI. See CONTRIBUTING.md for local setup.

Metadata

Release files for prompts-mcp 1.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for prompts-mcp 1.7.1
File	Size	Uploaded
prompts_mcp-1.7.1.tar.gz	6.6 kB	Nov 20, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for prompts-mcp 1.7.1
File	Interpreter	ABI	Platform	Reset
prompts_mcp-1.7.1-py3-none-any.whl 6.9 kB Nov 20, 2025	Python 3	none	any	Details

Total release size: 13.5 kB

Release files / prompts_mcp-1.7.1.tar.gz

Download URL	prompts_mcp-1.7.1.tar.gz
Size	6.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`f4b8932ee6e687a475836aec2e781bc8d23c0cc28d676c26b333b06191e5b053`
BLAKE2b-256 checksum How to use checksums	`4d7e48e6306525a042f8efbe76c4e861bd16f700bce600b76655bcc52e7a9f40`
Upload date	Nov 20, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / prompts_mcp-1.7.1-py3-none-any.whl

Download URL	prompts_mcp-1.7.1-py3-none-any.whl
Size	6.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4f77ca22bd2a066ffef7dce860c8a2686f8ea9f5feea71973f7940309c3ae651`
BLAKE2b-256 checksum How to use checksums	`4bef65dbbfdad4cead3b5c2b78ef1472536ea043b791f106abe9670837012d28`
Upload date	Nov 20, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`