# CloudZIR MCP Server
[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
[](https://vercel.com/)
[](LICENSE)
**CloudZIR MCP Server** is a Model Context Protocol (MCP) server implementation with integrated CloudZIR system prompts and context management for enterprise-grade AI applications.
## 🎯 Features
- 🤖 **Complete MCP Server Implementation** - Full compliance with Model Context Protocol specification
- 🎨 **CloudZIR System Prompts** - Master system prompts for consistent AI behavior
- 🏗️ **Enterprise Architecture** - Production-ready, scalable, and secure
- ⚡ **Zero Approximation** - Intelligent automation with strict validation
- 📦 **TypeScript Ready** - Full type safety and excellent IDE support
- 🚀 **Vercel Deployment** - One-click deployment to Vercel
- 🔒 **Security First** - Built-in security headers and best practices
## 📋 Requirements
- **Node.js**: >= 18.x
- **npm**: >= 9.x
- **Vercel Account** (for deployment)
## 🚀 Quick Start
### 1. Installation
```bash
# Clone the repository
git clone https://github.com/SourireConcept/cloudzir-mcp-server.git
cd cloudzir-mcp-server
# Install dependencies
npm install
```
### 2. Configuration
```bash
# Copy environment variables
cp .env.example .env
# Edit .env with your configuration
nano .env
```
### 3. Development
```bash
# Start development server
npm run dev
```
### 4. Production Build
```bash
# Build TypeScript
npm run build
# Start production server
npm start
```
## 📂 Project Structure
```
cloudzir-mcp-server/
├── src/
│ ├── index.ts # MCP Server entry point
│ └── prompts/
│ ├── system-prompts.ts # CloudZIR system prompts
│ └── cloudzir-context.ts # CloudZIR context & configuration
├── dist/ # Compiled JavaScript output
├── package.json # Dependencies & scripts
├── tsconfig.json # TypeScript configuration
├── vercel.json # Vercel deployment config
├── .env.example # Environment variables template
└── README.md # This file
```
## 🔐 Environment Variables
Create a `.env` file based on `.env.example`:
```env
# Server Configuration
NODE_ENV=production
PORT=3000
# AI Model Configuration
OPENAI_API_KEY=sk-your-key-here
HUGGINGFACE_API_KEY=hf_your-token-here
ANTHROPIC_API_KEY=sk-ant-your-key-here
# Database
DATABASE_URL=postgresql://...
# Logging
LOG_LEVEL=info
DEBUG=false
```
## 🌐 Deployment on Vercel
### Option 1: Using Vercel Dashboard
1. Go to [Vercel Dashboard](https://vercel.com/dashboard)
2. Click "Add New" → "Project"
3. Select your GitHub repository
4. Vercel will auto-detect `vercel.json` configuration
5. Add environment variables in project settings
6. Deploy!
### Option 2: Using Vercel CLI
```bash
# Install Vercel CLI
npm i -g vercel
# Deploy
vercel
# Add environment variables
vercel env add OPENAI_API_KEY
vercel env add ANTHROPIC_API_KEY
# Deploy with environment variables
vercel --prod
```
## 📡 API Usage
### Initialize MCP Client
```typescript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
const client = new Client({
name: "my-client",
version: "1.0.0",
});
// Connect to CloudZIR MCP Server
await client.connect(transport);
```
### Access System Prompts
```typescript
import { SYSTEM_PROMPTS, getSystemPrompt } from "./src/prompts/system-prompts";
// Get master system prompt
const masterPrompt = getSystemPrompt("master");
// Get development context prompt
const devPrompt = getSystemPrompt("development");
```
## 🏛️ CloudZIR System Prompts
### Master Prompt
The core AI consciousness with CloudZIR's fundamental rules:
- Zero approximation
- Production-ready by default
- Complete, coherent, and connected logic
- Security and scalability built-in
### Development Prompt
Specialized context for platform development with:
- Code quality standards
- Component architecture guidelines
- Error handling requirements
- Performance optimization rules
### Infrastructure Prompt
Cloud infrastructure and deployment guidance:
- Security-first approach
- Scalability planning
- Monitoring and observability
- Disaster recovery procedures
## 🔧 Available Commands
```bash
# Development
npm run dev # Start development server with hot reload
npm run build # Compile TypeScript to JavaScript
# Production
npm start # Run production server
npm run build && npm start
# Vercel
vercel # Deploy to Vercel (staging)
vercel --prod # Deploy to Vercel (production)
```
## 📚 Documentation
- [Model Context Protocol](https://modelcontextprotocol.io/)
- [Vercel Documentation](https://vercel.com/docs)
- [TypeScript Handbook](https://www.typescriptlang.org/docs/)
- [Node.js Documentation](https://nodejs.org/en/docs/)
## 🔒 Security
- ✅ All HTTP headers properly configured
- ✅ Input validation and sanitization
- ✅ Environment variables in `.env` (not committed)
- ✅ Secrets management through Vercel
- ✅ CORS configured for security
- ✅ SQL injection prevention
- ✅ XSS protection headers
## 🤝 Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/amazing-feature`
3. Commit your changes: `git commit -m 'Add amazing feature'`
4. Push to the branch: `git push origin feature/amazing-feature`
5. Open a Pull Request
## 📝 License
MIT License - see LICENSE file for details
## 👨💻 Author
**Sourire Concept**
- GitHub: [@SourireConcept](https://github.com/SourireConcept)
- Website: [sourire.concept](https://sourire.concept)
## 🙏 Acknowledgments
- CloudZIR Platform Team
- Model Context Protocol Developers
- Vercel Platform
- TypeScript Community
---
**Made with ❤️ by Sourire Concept**
