🔧 MCP RAPI

Modern API Permission Management System with MCP Integration

🎯 Features • 🚀 Quick Start • 📖 Documentation • 🤝 Contributing • 🌟 Star History

---

💡 What is MCP RAPI?

MCP RAPI (Model Context Protocol - Role-based API) is a modern, enterprise-grade API permission management system built with Go and Vue.js, designed specifically for MCP (Model Context Protocol) environments. It provides comprehensive RBAC (Role-Based Access Control) capabilities for managing API access permissions across your organization with seamless MCP integration.

🎯 Perfect for:

• 🤖 AI/LLM Applications - MCP-compatible API permission management
• 🏗️ Microservices Architecture - Centralized API permission control
• 🏢 Enterprise Applications - Multi-tenant permission management
• 👥 Development Teams - Streamlined API access workflows
• 🔄 DevOps Automation - Automated permission deployment

⚡ Key Features

🛠️ Tech Stack Backend Frontend DevOps & Infrastructure 📁 Project Structure 📦 mcp-rapi/ ├── 🔧 backend/ # Go Backend Service │ ├── 🚀 cmd/ # Application Entry Point │ │ └── main.go # Main application │ ├── ⚙️ configs/ # Configuration Files │ │ ├── dev.yaml # Development config │ │ ├── prod.yaml # Production config │ │ └── casbin_model.conf # Casbin RBAC model │ ├── 🏗️ internal/ # Internal Application Code │ │ ├── 🎯 domain/ # Business Domain Layer │ │ │ ├── 📋 entity/ # Domain Entities │ │ │ ├── 🗄️ repository/ # Repository Interfaces │ │ │ └── 🔧 service/ # Business Services │ │ ├── 🏭 infrastructure/ # Infrastructure Layer │ │ │ ├── 💾 cache/ # Redis Cache Implementation │ │ │ ├── 📦 container/ # Dependency Injection │ │ │ ├── 🗃️ database/ # Database Connection │ │ │ └── 🗄️ repository/ # Repository Implementation │ │ ├── 🛠️ pkg/ # Internal Utilities │ │ └── 🌐 transport/ # Transport Layer │ │ ├── 🔗 http/ # HTTP Handlers │ │ └── 🔒 middleware/ # HTTP Middleware │ ├── 📚 pkg/ # Public Utilities │ │ └── casbinx/ # Casbin Extensions │ └── 📜 scripts/ # Utility Scripts │ └── init_admin.go # Admin Initialization ├── 🎨 frontend/ # Vue.js Frontend │ ├── 🌍 public/ # Static Assets │ ├── 📝 src/ # Source Code │ │ ├── 🔌 api/ # API Client │ │ ├── 🎭 assets/ # Assets │ │ ├── 🧩 components/ # Vue Components │ │ ├── 🗺️ router/ # Vue Router Configuration │ │ ├── 🗃️ store/ # Vuex Store │ │ ├── 🎨 styles/ # Global Styles │ │ ├── 🛠️ utils/ # Utility Functions │ │ └── 👁️ views/ # Vue Views/Pages │ ├── 📦 package.json # NPM Dependencies │ └── ⚙️ vue.config.js # Vue CLI Configuration ├── 🐳 docker-compose.yml # Docker Compose Configuration ├── 🐳 docker-compose.dev.yml # Development Docker Compose ├── 📄 .env.example # Environment Variables Template ├── 🎨 assets/ # Project Assets │ └── logo.svg # Project Logo ├── 📚 docs/ # Documentation ├── 🚀 deploy/ # Deployment & Container Management │ ├── 🐳 docker-compose.ghcr.yml # GHCR Docker Compose │ ├── 🔧 build-and-push.sh # Build & Push Images Script │ ├── 🚀 deploy-ghcr.sh # GHCR Deployment Script │ ├── ⚙️ .env.production # Production Environment Config │ ├── 📖 README.md # Deployment Guide │ └── 📚 GITHUB_CONTAINER_REGISTRY_GUIDE.md # GHCR Guide ├── 🔧 mcp-example/ # MCP Integration Examples ├── fastmcp_http_server.py # FastMCP HTTP Server ├── requirements.txt # Python Dependencies └── start_fastmcp_http_server.sh # Startup Script 🚀 Quick Start 🐳 One-Click Docker Setup (Recommended) Get up and running in under 2 minutes: # 1. Clone the repository git clone https://github.com/chuangyeshuo/mcprapi.git cd mcprapi # 2. Start development environment (with hot reload & admin tools) docker-compose -f docker-compose.dev.yml up -d # 3. Check service status docker-compose -f docker-compose.dev.yml ps # 🎉 Your MCP RAPI system is now running! 🌐 Access URLs: Frontend Dashboard: http://localhost:8082 Backend API: http://localhost:8081 API Documentation: http://localhost:8081/swagger/index.html Health Check: http://localhost:8081/health Database Admin: http://localhost:8083 (Adminer) Redis Admin: http://localhost:8084 (Redis Commander) 🔑 Default Login: Username: admin Password: admin ⚠️ Security Note: Please change the default password immediately after first login! 🏭 Production Deployment 🐳 GitHub Container Registry (推荐) 使用预构建的Docker镜像快速部署： # 1. 进入部署目录 cd deploy # 2. 配置环境变量 cp .env.production .env # 编辑 .env 文件，设置必要的环境变量 # 3. 使用GHCR镜像启动服务 docker-compose -f docker-compose.ghcr.yml up -d # 4. 检查服务状态 docker-compose -f docker-compose.ghcr.yml ps 📚 详细指南: 查看 deploy/README.md 获取完整的部署说明 🏗️ 本地构建部署 # 1. Configure environment variables cp .env.example .env # Edit .env file with your production settings # 2. Start production environment docker-compose up -d # 3. Check service status docker-compose ps Production URLs: Frontend: http://localhost:8082 Backend API: http://localhost:8081 API Documentation: http://localhost:8081/swagger/index.html Health Check: http://localhost:8081/health 💻 Local Development Setup 📋 Prerequisites Go 1.21+ (Download) Node.js 18+ (Download) MySQL 8.0+ (Download) Redis 6.0+ (Download) Python 3.8+ (for MCP integration) 🔧 Backend Setup # Navigate to backend directory cd backend # Install Go dependencies go mod download # Copy and edit configuration cp configs/dev.yaml.example configs/dev.yaml # Edit configs/dev.yaml with your database settings # Initialize database (creates admin user) go run scripts/init_admin.go # Start the backend server with hot reload go run cmd/main.go --config configs/dev.yaml # 🚀 Backend running on http://localhost:8081 🎨 Frontend Setup # Navigate to frontend directory cd frontend # Install Node.js dependencies npm install # Start development server with hot reload npm run serve # 🎨 Frontend running on http://localhost:8080 🤖 MCP Server Setup (Optional) # Navigate to MCP example directory cd mcp-example # Install Python dependencies pip install -r requirements.txt # Start FastMCP HTTP server ./start_fastmcp_http_server.sh # 🤖 MCP Server running on http://localhost:8080 📖 Documentation 🔗 API Documentation Interactive API documentation is available once the system is running: 📚 Swagger UI: http://localhost:8081/swagger/index.html 🔑 Default Credentials 👤 Username: admin 🔒 Password: admin ⚠️ Security Note: Please change the default password immediately after first login! 📚 Additional Resources 📚 文档总览 - 完整文档导航和学习路径 🚀 Quick Start Guide - Start here for fastest setup! 📋 Complete Deployment Guide - Comprehensive deployment instructions 🏗️ System Architecture 🗃️ Database Setup Guide 🐳 Docker Deployment Guide 🏢 Department Management 🤖 MCP Integration Guide 🔧 Deployment Options 部署方式 适用场景 难度 推荐指数 文档链接 🐳 GitHub Container Registry 生产环境、快速部署 ⭐ ⭐⭐⭐⭐⭐ 部署指南 🐳 Docker Compose 生产环境、团队协作 ⭐⭐ ⭐⭐⭐⭐ 完整指南 💻 手动部署 学习研究、深度定制 ⭐⭐⭐⭐ ⭐⭐⭐ 手动部署 ☁️ 云原生部署 大规模生产环境 ⭐⭐⭐ ⭐⭐⭐⭐ 云原生指南 🎯 选择建议： 新手用户: 推荐使用 GitHub Container Registry 部署 - 最快最简单 开发者: 推荐查看 完整部署指南 了解所有选项 运维团队: 推荐阅读 性能优化 和 安全配置 章节 📋 相关工具： 🔑 GitHub Token 权限检查 - 验证部署权限 📊 构建状态查看 - 查看最新构建信息 🛠️ 故障排除指南 - 解决常见问题 🌟 Key Capabilities 🔐 Permission Management Fine-grained Control: API-level permission management Role-based Access: Hierarchical role system Dynamic Updates: Real-time permission changes Audit Trail: Complete permission history 🏢 Multi-tenant Architecture Organization Isolation: Complete data separation Department Hierarchy: Multi-level organizational structure Business Line Support: Cross-department collaboration Scalable Design: Supports thousands of users 🤖 MCP Integration Native Support: Built-in MCP protocol compatibility AI-Ready: Perfect for LLM and AI applications Context Management: Intelligent context handling Protocol Compliance: Full MCP specification support 🤝 Contributing We welcome contributions from the community! Here's how you can help make MCP RAPI even better: 🐛 Bug Reports Found a bug? Please create an issue with: Clear Description: What went wrong? Reproduction Steps: How can we reproduce it? Expected Behavior: What should have happened? Environment: OS, browser, versions, etc. 💡 Feature Requests Have a great idea? We'd love to hear it! Please include: Use Case: Why is this feature needed? Proposed Solution: How should it work? Examples: Any relevant examples or mockups 🔧 Development Workflow Fork the repository Create a feature branch (git checkout -b feature/amazing-feature) Commit your changes (git commit -m 'feat: add amazing feature') Push to the branch (git push origin feature/amazing-feature) Open a Pull Request 📝 Code Standards Go: Follow Go Code Review Comments Vue.js: Follow Vue.js Style Guide Commits: Use Conventional Commits Testing: Include tests for new features Documentation: Update docs for API changes 🌟 Star History 🚀 Roadmap GraphQL API Support - Alternative to REST APIs Advanced Analytics - Permission usage insights SSO Integration - SAML, OAuth2, OIDC support Mobile App - Native mobile management app Kubernetes Operator - K8s native deployment Advanced MCP Features - Enhanced protocol support 📄 License This project is licensed under the MIT License - see the LICENSE file for details. 🙏 Acknowledgments Special thanks to these amazing projects that make MCP RAPI possible: 🔐 Casbin - Authorization library that powers our RBAC 🌐 Gin - High-performance HTTP web framework 🎨 Vue.js - Progressive JavaScript framework 🧩 Element UI - Beautiful Vue.js component library 🤖 Model Context Protocol - AI context management standard 💬 Community & Support 💬 Discussions: GitHub Issues 🐛 Issues: GitHub Issues 📧 Email: [email protected] 📱 Discord: Join our Discord Made with ❤️ by the MCP RAPI Community ⭐ Star us on GitHub • 🐛 Report Bug • 💡 Request Feature • 💬 Join Discussion 🚀 Ready to revolutionize your API permission management? Get started now!