Baas MCP

🚀 BaaS SMS/MMS MCP Server

A comprehensive Model Context Protocol server for SMS and MMS messaging services that provides seamless integration with BaaS platforms through intelligent code generation and CDN optimization templates.

✨ Features

🚀 Overview

This MCP server acts as a bridge between AI development workflows and BaaS messaging platforms, offering the following:

• Intelligent Code Generation: Generate production-ready code for SMS/MMS integration.
• CDN-Optimized Templates: Fetch the latest code templates maintained on the CDN.
• Multi-Language and Framework Support: JavaScript, Python, PHP, along with React, Vue, Django, Laravel, etc.
• Token Efficiency: Minimize token usage through CDN-based template fetching.
• Environment Integration: Automatically inject API keys and manage environment variables.
• Platform-Specific Guides: Deployment and integration guides for major platforms.

📋 Architecture

System Components

┌─────────────────────────────────────────────────────────────────┐
│                    MCP Client                                 │
└─────────────────────────┬───────────────────────────────────────┘
                          │ MCP Protocol
┌─────────────────────────▼───────────────────────────────────────┐
│                    Node.js Wrapper (index.js)                   │
│                   - Cross-platform Compatibility                │
│                   - Dependency Management                     │
│                   - Process Lifecycle                           │
└─────────────────────────┬───────────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────────┐
│                Python MCP Server (server.py)                    │
│                   - FastMCP Framework                           │
│                   - CDN Template Fetching                       │
│                   - Code Generation and Customization           │
│                   - API Key Injection                           │
└─────────────────────────┬───────────────────────────────────────┘
                          │ HTTPS
┌─────────────────────────▼───────────────────────────────────────┐
│                   CDN Template Repository                       │
│                   - Language-Specific Templates                 │
│                   - Framework Integration                       │
│                   - Deployment Guides                           │
│                   - Project Helpers                             │
└─────────────────────────────────────────────────────────────────┘

Template Structure

templates/
├── javascript/
│   ├── vanilla.md          # Pure JavaScript implementation
│   └── react.md           # React component integration
├── python/
│   ├── vanilla.md          # Based on Python requests
│   └── django.md          # Django integration
├── php/
│   └── vanilla.md          # PHP cURL implementation
├── helpers/
│   └── javascript-project.md  # Project-specific utilities
└── deployment/
    └── vercel-production.md    # Platform deployment guide

📦 Installation

npm Installation (Recommended)

npm install -g baas-sms-mcp

Local Development Setup

git clone https://github.com/jjunmomo/BaaS-MCP.git
cd BaaS-MCP
npm install

Python Dependencies

The server manages Python dependencies automatically, but you can also install them manually:

pip install -r requirements.txt

⚙️ Configuration

MCP Client Configuration

Add to the MCP client configuration file:

{
  "mcpServers": {
    "baas-sms-mcp": {
      "command": "npx",
      "args": ["baas-sms-mcp"],
      "env": {
        "BAAS_API_KEY": "Replace_with_actual_API_key"
      }
    }
  }
}

Environment Variables

*Required for automatic API key injection into the generated code. The server can run without it, but manual key configuration is required.

🔧 Available Tools

1. get_code_template_url

Purpose: Get the CDN URL for an optimized code template without token overhead.

Parameters:

• language (string): Programming language
  • Supported: javascript, python, php, java, go, csharp
• framework (optional): Framework name
  • JavaScript: react, vue, angular
  • Python: django, fastapi, flask
  • PHP: laravel, symfony
• deployment_platform (optional): Target platform
  • vercel, netlify, aws, docker, etc.

Return Value:

{
  "success": true,
  "template_url": "https://cdn.mbaas.kr/templates/sms-mms/javascript/react.md",
  "integration_url": "https://cdn.mbaas.kr/templates/sms-mms/deployment/vercel.md",
  "api_endpoint": "https://api.aiapp.link/api/message/",
  "configuration": {
    "required_env_vars": ["BAAS_API_KEY"],
    "api_key_injected": true
  }
}

2. generate_direct_api_code

Purpose: Fetch and customize CDN templates to generate production-ready code.

Parameters:

• language (string, default: "javascript"): Target programming language
• framework (optional): Framework-specific implementation
• include_examples (boolean, default: true): Include usage examples

Return Value:

{
  "success": true,
  "code": "// Complete implementation code...",
  "filename": "baas-sms-service.js",
  "description": "JavaScript BaaS SMS service for direct /api/message/ API calls",
  "source": "CDN template",
  "configuration": {
    "env_vars": ["BAAS_API_KEY"],
    "install": "npm install (including dependencies)",
    "api_key_injected": true
  }
}

3. create_message_service_template

Purpose: Create a complete project-specific service template through customization.

Parameters:

• project_config (object，configuration of the project):

  {
    "default_callback": "02-1234-5678",
    "company_name": "Your Company"
  }
  

• language (string): Target programming language
• features (array, optional): Features to include
  • Available: ["sms", "mms", "status_check", "history", "validation"]

Return Value:

{
  "success": true,
  "code": "// Customized implementation with project defaults...",
  "filename": "Your_Company_Message_Service.js",
  "description": "Message service template for your company",
  "source": "CDN template + project customization"
}

4. get_integration_guide

Purpose: Get detailed platform-specific deployment and integration guides.

Parameters:

• platform (string): Target platform
  • Supported: vercel, netlify, heroku, aws, gcp, azure, docker
• deployment_type (string, default: "production"): Deployment environment
  • Options: development, staging, production

Return Value:

{
  "success": true,
  "platform": "vercel",
  "deployment_type": "production",
  "guide_content": "# Vercel Deployment Guide\n...",
  "security_checklist": [
    "Do not hardcode API keys in the code",
    "Use environment variables or secret management services",
    "Ensure HTTPS communication",
    "Set up appropriate error logging"
  ]
}

🚨 Important API Changes

The BaaS platform has been updated with major changes:

New API Structure

• Base URL: https://api.aiapp.link
• SMS Endpoint: /api/message/sms
• MMS Endpoint: /api/message/mms
• Authentication: Use only the X-API-KEY header

Major Changes

• ❌ The PROJECT_ID parameter has been removed from all API calls.
• ❌ The use of previous endpoints has been discontinued.
• ✅ Simplified authentication with only an API key.
• ✅ Updated response format

Migration Guide

// Previous (deprecated)
const response = await fetch('https://api.aiapp.link/message/sms', {
  headers: {
    'Authorization': `Bearer ${jwt_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    project_id: "uuid-string",
    // ... other parameters
  })
});

// Current (new)
const response = await fetch('https://api.aiapp.link/api/message/sms', {
  headers: {
    'X-API-KEY': process.env.BAAS_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    // project_id removed
    // ... other parameters
  })
});

💻 Usage Examples

Create a React SMS Component

// Create a React component with TypeScript
const result = await mcp.generate_direct_api_code("javascript", "react", true);
console.log(result.code); // Complete React component

Create a Company-Specific Template

const projectConfig = {
  default_callback: "02-1234-5678",
  company_name: "MyTech Corporation"
};

const template = await mcp.create_message_service_template(
  projectConfig, 
  "python", 
  ["sms", "mms", "status_check"]
);

// Return a customized Python service class with company defaults

Get the Vercel Deployment Guide

const guide = await mcp.get_integration_guide("vercel", "production");
console.log(guide.guide_content); // Complete deployment instructions

Get Template URLs for Token Efficiency

const urls = await mcp.get_code_template_url("python", "django", "heroku");
console.log(urls.template_url);     // CDN template URL
console.log(urls.integration_url);  // Platform-specific guide URL

🏗 Development

Run Locally

# Start the MCP server
node index.js

# Test with environment variables
BAAS_API_KEY="test" node index.js

Project Structure

BaaS-MCP/
├── index.js                 # Node.js wrapper and dependency management
├── baas_sms_mcp/
│   ├── __init__.py         # Python package initialization
│   └── server.py           # Main MCP server implementation
├── templates/              # Local template fallback
├── requirements.txt        # Python dependencies
├── package.json           # Node.js package configuration
├── pyproject.toml         # Python package configuration
└── mcp.config.json        # Example MCP configuration

Release Process

# Patch version (bug fixes)
npm run release:patch

# Minor version (new features)
npm run release:minor

# Major version (major changes)
npm run release:major

🔒 Security Best Practices

API Key Management

• Do not hardcode API keys in the source code.
• Use environment variables or secret management services.
• Regularly rotate API keys.
• Monitor API key usage.

Deployment Security

• Enable HTTPS for all communication.
• Thoroughly validate input data.
• Implement appropriate error handling and logging.
• Follow the principle of least privilege.

Code Generation Security

• Fetch templates from trusted CDN sources.
• Automatically sanitize inputs.
• Do not execute code generated by the MCP server.
• Clearly separate templates from the runtime environment.

🤝 Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/new-feature.
3. Make changes and test thoroughly.
4. Commit with a clear message: git commit -m "Add new feature".
5. Push to your fork: git push origin feature/new-feature.
6. Create a Pull Request.

📊 Performance and Monitoring

Token Efficiency

• Reduce token usage by 60-80% with CDN-based templates.
• Minimize duplicate API calls with intelligent caching.
• Optimized response format for the MCP protocol.

Monitoring

• Built-in error logging and reporting.
• Monitor CDN performance.
• Track API key usage.
• Measure template fetch success rate.

📄 License

This project is under the MIT License. See the LICENSE file for details.

🆘 Support and Community

• GitHub Issues: Report bugs or request features
• Email Support: support@aiapp.link
• Documentation: API Specification
• English Documentation: README.md

🗺 Roadmap

Planned Features

• [ ] Support for additional languages (Java, Go, C#)
• [ ] Advanced template customization options
• [ ] Real-time template updates
• [ ] Template version management
• [ ] Improved error reporting and debugging
• [ ] Integration with popular IDE extensions

Version History

• v1.0.18: Current stable release with API updates
• v1.0.0: Initial stable release
• v0.1.4: Beta release with core features