PromptLab (PromptVault)

Self-hosted AI prompt library for individuals and teams. Self-hosted in Russia. Works with Claude via a built-in MCP server.

🌐 promtlabs.ru · 📖 Documentation · 🔌 MCP · 📝 Changelog

What is it

PromptLab is a self-hosted web application for managing a library of prompts for Claude (Opus / Sonnet / Haiku). It solves three tasks:

1. Organization — collections, tags, hierarchy, versions, trash bin, search.

2. Teamwork — sharing prompts with the team, roles (owner / editor / viewer), shared collections.

3. Integration with Claude — the built-in MCP server allows Claude to search, read, and update your prompts directly from the chat.

Features

• 🇷🇺 Interface in Russian, self-hosted in Russia (Timeweb hosting)

• 🔌 MCP-server v1.2+ — 30 tools, published in the Official MCP Registry

• 👥 Teams with roles (owner / editor / viewer), 2FA for admins

• 💳 Plans: Free (0₽), Pro (599₽/mo), Max (1299₽/mo), payment via T-Bank

• 🧩 Integration with Claude Code, Claude Desktop, Cursor, Windsurf

• 🔐 OAuth 2.0 + PKCE for GitHub / Google / Yandex, TOTP 2FA for admins

• 📊 Prompt versioning, public links, sharing

• 🤖 AI prompt improvement (Claude Sonnet 4) with plan-based quotas

• 🌐 PWA, Telegram bot, browser extension

Stack

Backend: Go 1.25 · Chi v5 · GORM v2 · PostgreSQL 18 · slog · koanf Frontend: React 19 · Vite 8 · shadcn/ui · Tailwind 4 · TanStack Query · Zustand Infra: Docker Compose · GlitchTip (self-hosted Sentry) · GitHub Actions CI/CD MCP: modelcontextprotocol/go-sdk v1.5, Streamable HTTP transport

More details — promptvault/CLAUDE.md (architecture, Clean Architecture layers, conventions).

Quick Start (dev)

git clone https://github.com/Slava4123/promtlab.git
cd promtlab/promptvault
cp .env.example .env  # заполнить DATABASE_*, JWT_SECRET, OPENROUTER_API_KEY
docker compose -f docker-compose.dev.yml up

• Frontend: http://localhost:5173

• Backend API: http://localhost:8080

• MCP endpoint: http://localhost:8080/mcp

Create the first admin:

docker compose exec api go run ./cmd/create-admin --email=you@example.com

Connecting to Claude (MCP)

claude mcp add --transport http promtlab https://promtlabs.ru/mcp \
  --header "Authorization: Bearer pvlt_YOUR_API_KEY"

API keys are created at https://promtlabs.ru/settings/integrations.

Full guide and list of all 30 tools — promptvault/docs/MCP.md.

License

Functional Source License 1.1 (Apache-2.0 Future License)

• ✅ You can self-host, fork, modify, and use it within your company

• ❌ You cannot create a competing SaaS for 2 years

• 🔓 After 2 years, each release automatically becomes Apache 2.0

For commercial inquiries: slava0gpt@gmail.com.

Security

Found a vulnerability? Email slava0gpt@gmail.com or use the GitHub Security Advisory. Details — SECURITY.md.

Contacts

• 🌐 Website: https://promtlabs.ru

• 📧 Email: slava0gpt@gmail.com

• 📬 Telegram: @promtlabs

Made in Russia with ❤️ for those who work extensively with AI.