PromptHub是一个全面的提示词管理平台，为AI开发者、内容创作者和企业用户提供创建、管理、分享和分析AI提示词的工具。

• 🤖 智能提示词管理 - 创建、编辑、版本控制和分类管理
• 🔌 MCP协议支持 - 与Claude Desktop、Cursor等AI工具无缝集成
• 📊 性能分析 - 详细的使用统计和优化建议
• 🚀 RESTful API - 完整的API支持，方便第三方集成
• 🛡️ 安全认证 - 用户管理、权限控制和API密钥管理
• ⚡ AI智能辅助 - 自动分类、标签提取和内容优化

PromptHub/
├── web/                      # Next.js前端应用
│   ├── src/pages/docs/       # 用户文档（使用指南）
│   ├── src/components/       # React组件
│   └── src/lib/              # 工具函数和API客户端
├── mcp/                      # MCP服务器
│   ├── src/                  # 核心业务逻辑
│   └── tools/                # MCP工具实现
├── supabase/                 # 数据库配置
│   ├── migrations/           # 数据库迁移
│   └── schema.sql            # 数据库架构
├── docs/                     # 开发者技术文档
├── scripts/                  # 辅助脚本
└── .env                      # 环境配置（统一配置文件）

位置：web/src/pages/docs/

• 入门指南 - 快速开始使用PromptHub
• 基础功能 - 核心功能详解和使用方法
• MCP集成 - 与AI工具的集成指南
• API集成 - REST API使用指南
• 最佳实践 - 提示词设计和优化技巧
• 示例库 - 丰富的使用示例和模板

位置：docs/

• setup/npm-quick-start.md - NPM快速安装和使用指南
• setup/npm-package.md - NPM包详细说明和配置
• setup/mcp-setup.md - MCP适配器详细配置指南

• deployment/docker-deployment.md - Docker部署配置和说明

• development/developer-guide.md - 项目开发指南和架构说明
• development/database-structure.md - 数据库设计和表结构

• security/security-guide.md - 安全配置和最佳实践
• security/security-implementation.md - 友好安全增强实施方案
• security/security-audit-fixes.md - 安全审计报告与修复方案
• security/permission-management.md - 权限管理系统设计
• security/security-levels-config-guide.md - 安全级别配置指南
• security/security-usage-guide.md - 安全功能使用说明
• security/supabase-security-config.md - Supabase安全配置

• mcp/mcp-zero-config-examples.md - MCP零配置示例
• mcp/mcp-universal-config.md - MCP通用配置指南
• mcp/mcp-simple-config.md - MCP简化配置指南
• mcp/mcp-usage-guide.md - MCP使用指南
• mcp/SEARCH_INTEGRATION_GUIDE.md - 搜索集成指南
• mcp/UNIFIED_SEARCH_GUIDE.md - 统一搜索指南
• mcp/UNIFIED_STORE_GUIDE.md - 统一存储指南

• Node.js ≥ 18.0.0
• Docker & Docker Compose
• PostgreSQL（或使用Supabase）

1. 克隆项目

   git clone https://github.com/xiiizoux/PromptHub.git
   cd PromptHub

2. 环境配置

   cp .env.example .env
   # 编辑 .env 文件，配置必要的环境变量

3. 安装依赖

   # 安装所有依赖
   npm run install:all

4. 启动服务

   # 启动开发环境
   npm run dev
   
   # 或使用Docker
   docker-compose up -d

5. 访问应用

   • Web界面：http://localhost:9011
   • MCP服务器：http://localhost:9010
   • 文档中心：http://localhost:9011/docs

项目使用统一的.env文件进行配置：

# 数据库配置
SUPABASE_URL=your-supabase-url
SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# AI服务配置
OPENAI_API_KEY=your-openai-api-key
OPENAI_API_BASE_URL=https://api.openai.com/v1

# 服务端口
WEB_PORT=9011
MCP_PORT=9010

# JWT配置
JWT_SECRET=your-jwt-secret

# 安全配置
SECURITY_LEVEL=balanced  # loose/balanced/strict

# Google OAuth（可选）
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

支持与多种AI工具集成：

• Claude Desktop - Anthropic官方桌面应用
• Cursor IDE - AI编程开发环境
• 自定义工具 - 任何支持MCP协议的工具

详细配置请参考：MCP集成指南

• 创建和编辑提示词
• 版本控制和历史记录
• 分类和标签管理
• 批量导入导出

• 自动分类和标签提取
• 模板变量识别
• 改进建议生成
• 使用场景分析

• 使用统计和趋势分析
• 响应时间监控
• Token消耗统计
• A/B测试支持

• RESTful API
• MCP协议支持
• Webhook通知
• 第三方工具集成

cd web
npm run dev

cd mcp
npm run dev

cd supabase
npx supabase db push

# 构建所有服务
npm run build

# Docker部署
docker-compose -f docker-compose.prod.yml up -d

• 在线文档：http://localhost:9011/docs
• API参考：http://localhost:9011/docs/api-integration
• MCP集成：http://localhost:9011/docs/mcp-integration

• NPM快速开始：docs/setup/npm-quick-start.md
• MCP设置指南：docs/setup/mcp-setup.md
• Docker部署：docs/deployment/docker-deployment.md

• 开发者指南：docs/development/developer-guide.md
• 数据库结构：docs/development/database-structure.md

• 安全配置：docs/security/security-guide.md
• 安全实施方案：docs/security/security-implementation.md
• 安全审计报告：docs/security/security-audit-fixes.md
• 安全使用指南：docs/security/security-usage-guide.md

• MCP零配置示例：docs/mcp/mcp-zero-config-examples.md
• MCP通用配置：docs/mcp/mcp-universal-config.md
• 统一搜索指南：docs/mcp/UNIFIED_SEARCH_GUIDE.md

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

如果您遇到问题或需要帮助：

1. 查看在线文档
2. 搜索已知问题
3. 创建新问题

PromptHub - 让AI提示词管理变得简单高效 🚀