promptbin 0.1.0

Easy-to-use MCP server for prompt management with web interface and secure sharing

PromptBin - MCP Server Example

The easiest way to run a Model Context Protocol (MCP) server with full prompt management.

Quick Start

# Install from PyPI
uv add promptbin

# Run MCP server (auto-launches web interface)
uv run promptbin-mcp

That's it! PromptBin is now running as an MCP server with a web interface at http://localhost:5000.

Add to AI Tools

Claude Desktop (Mac/Windows)

Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "promptbin": {
      "command": "uv",
      "args": ["run", "promptbin-mcp"],
      "workingDirectory": "/path/to/your/project"
    }
  }
}

ChatGPT Desktop (Mac/Windows)

• Open Settings → Developer → Model Context Protocol
• Click "Add Server"
• Name: promptbin
• Command: uv
• Args: run promptbin-mcp

Key Features

• 🚀 Easy setup: One command to get started
• 🔗 MCP integration: Full Model Context Protocol support
• 🌐 Web interface: Auto-launching prompt management UI
• 🔒 Secure sharing: Share prompts via Dev Tunnels with rate limiting
• 📁 Local-first: Your data stays private, stored locally
• ⚙️ Production-ready: Comprehensive logging and error handling

Alternative Usage

Standalone Web Interface

Run just the web interface without MCP:

uv run promptbin

Open your browser to http://localhost:5001

Development Mode

For development or customization:

git clone https://github.com/ianphil/promptbin
cd promptbin
uv sync
uv run promptbin-mcp

What You Get

• ✅ Complete MCP server - Full Model Context Protocol implementation
• ✅ Auto-launching web UI - Prompt management interface at localhost:5000
• ✅ AI tool integration - Works with Claude Desktop, ChatGPT Desktop
• ✅ Secure sharing - Share prompts publicly via Dev Tunnels
• ✅ File-based storage - No database required, organized by category
• ✅ Cross-platform - Windows, macOS, Linux support
• ✅ Production-ready - Rate limiting, logging, graceful shutdown

Advanced Features

Secure Public Sharing (Optional)

PromptBin includes Microsoft Dev Tunnels integration for sharing prompts publicly:

# Install Dev Tunnels CLI
uv run promptbin-install-tunnel

# Authenticate (one-time setup)
devtunnel user login -g

# Start PromptBin, then click "Start Tunnel" in the footer

Now your shared prompts get public URLs that work from anywhere. Includes automatic rate limiting and security protections.

For detailed setup instructions, see TUNNELS.md.

System Validation

# Check if your system is ready
uv run promptbin-setup

Add MCP Server to ChatGPT & Claude (Desktop)

Prereq: install deps first (uv sync). The apps will launch the MCP server themselves.

ChatGPT Desktop (Mac/Windows):

• Open Settings → Developer → Model Context Protocol.
• Click “Add Server”.
• Name: PromptBin
• Command: uv
• Args: run python mcp_server.py
• Working directory: path to this repo.

Claude Desktop (Mac/Windows):

• Open Settings → Developer → Edit Config

"PromptBin": {
            "command": "/Users/ianphil/.local/bin/uv",
            "args": [
                "run",
                "/Users/ianphil/src/promptbin/.venv/bin/python",
                "/Users/ianphil/src/promptbin/mcp_server.py"
            ],
            "workingDirectory": "/Users/ianphil/src/promptbin"
        }

Notes:

• After adding, you can list/search prompts via the PromptBin MCP tools. The MCP server also starts the local web UI on http://127.0.0.1:<port>.
• If uv is not on PATH, replace uv with the full path or use your Python venv: python mcp_server.py.