<div align="center">

🚀 MCP Prompt Server

A lightweight Model Context Protocol server for dynamic prompt management

</div>

---

✨ Features

• 📁 Dynamic Prompt Loading — Automatically discover and register markdown files from the prompts/ directory
• 📚 Resource Management — Serve documentation and reference materials via MCP resources
• ⚡ Zero Configuration — Add prompts and resources by simply creating markdown files with YAML frontmatter
• 🔒 Security First — Built-in path traversal protection, file size limits, and input validation
• 🎯 MCP Compliant — Full implementation of MCP prompt and resource primitives via FastMCP framework
• 🌐 Remote Installation — Run directly from GitHub without cloning

🔧 Requirements

• Python >=3.11
• Package manager: uv (installs automatically with uvx)

Quick Start

Using with Claude Cli

Add this configuration to your Claude Cli MCP settings:

{
  "mcpServers": {
    "prompt-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/marcmodin/mcp-prompt-server@v0.1.0",
        "mcp-prompt-server"
      ]
    }
  }
}

Using with GitHub Copilot

Create .vscode/mcp.json in your project:

{
  "mcpServers": {
    "prompt-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/marcmodin/mcp-prompt-server@v0.1.0r",
        "mcp-prompt-server"
      ]
    }
  }
}

Running Remotely

# Run directly from GitHub
uvx --from git+https://github.com/marcmodin/mcp-prompt-server@v0.1.0 mcp-prompt-server

# Debug with MCP Inspector
npx @modelcontextprotocol/inspector uvx --from git+https://github.com/marcmodin/mcp-prompt-server@v0.1.0 mcp-prompt-server

📚 Documentation

• Architecture — System design and security model
• Contributing — Development workflow and guidelines
• Prompt Template — Creating prompt files