# PromptBin - MCP Server Example
**The easiest way to run a Model Context Protocol (MCP) server with full prompt management.**
## Setup
### 1. Install and Configure
```bash
# Install PromptBin
pip install promptbin
# Install Dev Tunnels CLI (optional, for public sharing)
promptbin-install-tunnel
# Authenticate with Dev Tunnels (optional, one-time setup)
devtunnel user login -g
# Verify setup
promptbin-setup
```
### 2. Add to Your AI Client
**Claude Desktop** - Add to Settings → Developer → Edit Config:
```json
{
"mcpServers": {
"promptbin": {
"type": "stdio",
"command": "promptbin"
}
}
}
```
### 3. Start Using
That's it! PromptBin is now running:
- **Web UI**: `http://localhost:5001` - Manage and create prompts
- **MCP Server**: Ready for AI tool connections
## 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
## Usage Options
```bash
# Default: Run both MCP server and web interface
promptbin
# Run only MCP server (for AI tools)
promptbin --mcp
# Run only web interface (standalone)
promptbin --web
# Custom port and options
promptbin --port 8080 --data-dir ~/my-prompts
```
### Development Mode
For development or customization:
```bash
git clone https://github.com/ianphil/promptbin
cd promptbin
uv sync
uv run promptbin
```
## 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:
```bash
# 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](TUNNELS.md).
### System Validation
```bash
# 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
```json
"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`.
Raw data
{
"_id": null,
"home_page": null,
"name": "promptbin",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "PromptBin Contributors <noreply@promptbin.dev>",
"keywords": "ai, chatgpt, claude, mcp, model-context-protocol, prompt-management, prompts",
"author": null,
"author_email": "PromptBin Contributors <noreply@promptbin.dev>",
"download_url": "https://files.pythonhosted.org/packages/5e/6b/f4f44d1aaf500d30d0077cc6624491fbfcfac2ebe9539eab77bc5e4a488e/promptbin-0.3.4.tar.gz",
"platform": null,
"description": "# PromptBin - MCP Server Example\n\n**The easiest way to run a Model Context Protocol (MCP) server with full prompt management.**\n\n## Setup\n\n### 1. Install and Configure\n\n```bash\n# Install PromptBin\npip install promptbin\n\n# Install Dev Tunnels CLI (optional, for public sharing)\npromptbin-install-tunnel\n\n# Authenticate with Dev Tunnels (optional, one-time setup)\ndevtunnel user login -g\n\n# Verify setup\npromptbin-setup\n```\n\n### 2. Add to Your AI Client\n\n**Claude Desktop** - Add to Settings \u2192 Developer \u2192 Edit Config:\n```json\n{\n \"mcpServers\": {\n \"promptbin\": {\n \"type\": \"stdio\",\n \"command\": \"promptbin\"\n }\n }\n}\n```\n\n### 3. Start Using\n\nThat's it! PromptBin is now running:\n- **Web UI**: `http://localhost:5001` - Manage and create prompts\n- **MCP Server**: Ready for AI tool connections\n\n## Key Features\n- **\ud83d\ude80 Easy setup**: One command to get started\n- **\ud83d\udd17 MCP integration**: Full Model Context Protocol support\n- **\ud83c\udf10 Web interface**: Auto-launching prompt management UI\n- **\ud83d\udd12 Secure sharing**: Share prompts via Dev Tunnels with rate limiting\n- **\ud83d\udcc1 Local-first**: Your data stays private, stored locally\n- **\u2699\ufe0f Production-ready**: Comprehensive logging and error handling\n\n## Usage Options\n\n```bash\n# Default: Run both MCP server and web interface\npromptbin\n\n# Run only MCP server (for AI tools)\npromptbin --mcp\n\n# Run only web interface (standalone)\npromptbin --web\n\n# Custom port and options\npromptbin --port 8080 --data-dir ~/my-prompts\n```\n\n### Development Mode\nFor development or customization:\n```bash\ngit clone https://github.com/ianphil/promptbin\ncd promptbin\nuv sync\nuv run promptbin\n```\n\n## What You Get\n\n- \u2705 **Complete MCP server** - Full Model Context Protocol implementation\n- \u2705 **Auto-launching web UI** - Prompt management interface at localhost:5000\n- \u2705 **AI tool integration** - Works with Claude Desktop, ChatGPT Desktop\n- \u2705 **Secure sharing** - Share prompts publicly via Dev Tunnels\n- \u2705 **File-based storage** - No database required, organized by category\n- \u2705 **Cross-platform** - Windows, macOS, Linux support\n- \u2705 **Production-ready** - Rate limiting, logging, graceful shutdown\n\n## Advanced Features\n\n### Secure Public Sharing (Optional)\nPromptBin includes Microsoft Dev Tunnels integration for sharing prompts publicly:\n\n```bash\n# Install Dev Tunnels CLI\nuv run promptbin-install-tunnel\n\n# Authenticate (one-time setup)\ndevtunnel user login -g\n\n# Start PromptBin, then click \"Start Tunnel\" in the footer\n```\n\nNow your shared prompts get public URLs that work from anywhere. Includes automatic rate limiting and security protections.\n\nFor detailed setup instructions, see [TUNNELS.md](TUNNELS.md).\n\n### System Validation\n```bash\n# Check if your system is ready\nuv run promptbin-setup\n```\n\n## Add MCP Server to ChatGPT & Claude (Desktop)\n\nPrereq: install deps first (`uv sync`). The apps will launch the MCP server themselves.\n\nChatGPT Desktop (Mac/Windows):\n- Open Settings \u2192 Developer \u2192 Model Context Protocol.\n- Click \u201cAdd Server\u201d.\n- Name: PromptBin\n- Command: `uv`\n- Args: `run python mcp_server.py`\n- Working directory: path to this repo.\n\nClaude Desktop (Mac/Windows):\n- Open Settings \u2192 Developer \u2192 Edit Config\n\n```json\n\"PromptBin\": {\n \"command\": \"/Users/ianphil/.local/bin/uv\",\n \"args\": [\n \"run\",\n \"/Users/ianphil/src/promptbin/.venv/bin/python\",\n \"/Users/ianphil/src/promptbin/mcp_server.py\"\n ],\n \"workingDirectory\": \"/Users/ianphil/src/promptbin\"\n }\n```\n\nNotes:\n- 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>`.\n- If `uv` is not on PATH, replace `uv` with the full path or use your Python venv: `python mcp_server.py`.\n",
"bugtrack_url": null,
"license": null,
"summary": "Easy-to-use MCP server for prompt management with web interface and secure sharing",
"version": "0.3.4",
"project_urls": {
"Documentation": "https://github.com/ianphil/promptbin#readme",
"Homepage": "https://github.com/ianphil/promptbin",
"Issues": "https://github.com/ianphil/promptbin/issues",
"Repository": "https://github.com/ianphil/promptbin"
},
"split_keywords": [
"ai",
" chatgpt",
" claude",
" mcp",
" model-context-protocol",
" prompt-management",
" prompts"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1f95d6e4445ef56a4dd5ac0645ccb77c36c985784aaa5ff3307cc8cf541cd32e",
"md5": "8f3cf0b75a1cdfc559bff7b7dfb36b01",
"sha256": "8908a243064c40d0bc6b69eb27aba86925eadd79b8785523791786756f6a7bb0"
},
"downloads": -1,
"filename": "promptbin-0.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8f3cf0b75a1cdfc559bff7b7dfb36b01",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 170588,
"upload_time": "2025-09-08T13:11:28",
"upload_time_iso_8601": "2025-09-08T13:11:28.652932Z",
"url": "https://files.pythonhosted.org/packages/1f/95/d6e4445ef56a4dd5ac0645ccb77c36c985784aaa5ff3307cc8cf541cd32e/promptbin-0.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5e6bf4f44d1aaf500d30d0077cc6624491fbfcfac2ebe9539eab77bc5e4a488e",
"md5": "451ac346b37c83ad8e53053c14dbd97f",
"sha256": "ee25df94c564a48053592e6ec4d183eeb2ac83555592eae8ca04b4295dd9466a"
},
"downloads": -1,
"filename": "promptbin-0.3.4.tar.gz",
"has_sig": false,
"md5_digest": "451ac346b37c83ad8e53053c14dbd97f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 122819,
"upload_time": "2025-09-08T13:11:30",
"upload_time_iso_8601": "2025-09-08T13:11:30.140284Z",
"url": "https://files.pythonhosted.org/packages/5e/6b/f4f44d1aaf500d30d0077cc6624491fbfcfac2ebe9539eab77bc5e4a488e/promptbin-0.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 13:11:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ianphil",
"github_project": "promptbin#readme",
"github_not_found": true,
"lcname": "promptbin"
}
JSON
