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 nameexpirationTimeStart(optional): Start expiration date (yyyy-MM-dd)expirationTimeEnd(optional): End expiration date (yyyy-MM-dd)iccidStart(optional): ICCID start rangeiccidEnd(optional): ICCID end rangelabel(optional): SIM card labelsimState(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
- Go to https://playground.ai.cloudflare.com/
- Enter your deployed MCP server URL (
your-cmp-server.workers.dev/sse) - 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
- ✅
.gitignoreconfigured for security
License
MIT License - see LICENSE file for details.