CMP MCP Server

A Model Context Protocol (MCP) server for CMP (Connectivity Management Platform) API integration, built for Cloudflare Workers.

Features

• 🔍 Query SIM List - Retrieve SIM cards with filtering options (status, date range, ICCID range, etc.)
• 📱 Query SIM Details - Get comprehensive SIM card information including usage statistics
• 🔐 Secure Authentication - HMAC-SHA256 signature-based API authentication
• ☁️ Cloudflare Workers - Serverless deployment with global edge network
• 🌐 MCP Compatible - Works with Claude Desktop and other MCP clients

Quick Start

1. Environment Setup

Create your environment variables in Cloudflare Workers dashboard:

# Required environment variables (set as secrets in Cloudflare)
CMP_APP_KEY=your_cmp_app_key
CMP_APP_SECRET=your_cmp_app_secret

The CMP_ENDPOINT is already configured in wrangler.jsonc.

2. Deploy to Cloudflare Workers

# Install dependencies
npm install

# Deploy to Cloudflare Workers
npm run deploy

3. Local Development

# Copy environment template
cp .env.example .env

# Edit .env with your actual credentials
# Then start development server
npm run dev

Configuration

Environment Variables

Variable	Description	Required
CMP_APP_KEY	Your CMP API application key	✅
CMP_APP_SECRET	Your CMP API application secret	✅
CMP_ENDPOINT	CMP API endpoint URL	❌ (defaults to production)

Setting Secrets in Cloudflare

# Set your API credentials as secrets
wrangler secret put CMP_APP_KEY
wrangler secret put CMP_APP_SECRET

Available Tools

query_sim_list

Query SIM cards with filtering options.

Parameters:

• pageNum (optional): Page number (default: 1)
• pageSize (optional): Records per page (default: 10, max: 1000)
• enterpriseDataPlan (optional): Enterprise data plan name
• expirationTimeStart (optional): Start expiration date (yyyy-MM-dd)
• expirationTimeEnd (optional): End expiration date (yyyy-MM-dd)
• iccidStart (optional): ICCID start range
• iccidEnd (optional): ICCID end range
• label (optional): SIM card label
• simState (optional): SIM state (2=Pre-activation, 3=Test, 4=Silent, 5=Standby, 6=Active, 7=Shutdown, 8=Pause, 10=Pre-logout, 11=Logout)
• simType (optional): SIM card type

query_sim_detail

Get detailed information for a specific SIM card.

Parameters:

• iccid (required): SIM card ICCID number

Connect to Claude Desktop

To connect your MCP server to Claude Desktop, follow Anthropic's Quickstart and update your Claude Desktop configuration:

{
  "mcpServers": {
    "cmp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-cmp-server.workers.dev/sse"
      ]
    }
  }
}

Connect to Cloudflare AI Playground

1. Go to https://playground.ai.cloudflare.com/
2. Enter your deployed MCP server URL (your-cmp-server.workers.dev/sse)
3. Start using your CMP tools directly!

Development

Project Structure

src/
├── index.ts        # Main MCP server implementation
├── cmp_client.ts   # CMP API client with authentication
└── ...

Scripts

npm run dev         # Start development server
npm run deploy      # Deploy to Cloudflare Workers
npm run type-check  # Run TypeScript type checking
npm run lint:fix    # Fix linting issues
npm run format      # Format code

Security

• ✅ API credentials stored as Cloudflare Workers secrets
• ✅ HMAC-SHA256 signature authentication
• ✅ Environment variables validation
• ✅ No sensitive data in source code
• ✅ .gitignore configured for security

License

MIT License - see LICENSE file for details.