CloudZIR MCP Server

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

# Clone the repository
git clone https://github.com/SourireConcept/cloudzir-mcp-server.git
cd cloudzir-mcp-server

# Install dependencies
npm install

2. Configuration

# Copy environment variables
cp .env.example .env

# Edit .env with your configuration
nano .env

3. Development

# Start development server
npm run dev

4. Production Build

# 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:

# 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

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

# 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

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

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

# 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

• Vercel Documentation

• TypeScript Handbook

• Node.js Documentation

🔒 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

• Website: sourire.concept

🙏 Acknowledgments

• CloudZIR Platform Team

• Model Context Protocol Developers

• Vercel Platform

• TypeScript Community

Made with ❤️ by Sourire Concept