Supports containerized deployment with Docker configurations for running the shipping control center in containerized environments.
Provides production-ready orchestration capabilities with Kubernetes manifests for deploying and managing the shipping platform at scale.
Built on Node.js runtime environment for executing the shipping and order management server operations.
Uses npm package manager for dependency management and project build processes.
Alternative package manager option for faster and more efficient dependency installation and management.
Integrates with Prometheus for comprehensive metrics collection and monitoring of shipping operations and system performance.
Implemented in TypeScript providing full type safety throughout the shipping and order management application.
MCP Shipping Control Center
A comprehensive shipping and order management platform built with the Model Context Protocol (MCP), integrating EasyPost shipping services and Veeqo order management.
🚀 Features
Core Functionality
Order Management: Create, update, and track orders through Veeqo integration
Shipping Management: Generate labels, track shipments, and manage rates via EasyPost
Unified Workflows: Cross-platform operations combining order and shipping data
Real-time Dashboard: Web-based interface for monitoring operations
Authentication: JWT-based security with role-based access control
Technical Features
MCP Protocol: JSON-RPC 2.0 compliant API
TypeScript: Full type safety throughout the application
Error Handling: Comprehensive error management with retry logic
Logging: Structured logging with correlation IDs
Testing: Complete test coverage for all components
Docker: Containerized deployment ready
Kubernetes: Production-ready orchestration
📁 Project Structure
🛠️ Installation
Prerequisites
Node.js 18+
npm or pnpm
Docker (optional)
Kubernetes cluster (optional)
Setup
Clone and install dependencies:
Environment configuration:
Required environment variables:
🚀 Usage
Development
Production
📡 API Reference
MCP Methods
Veeqo Methods
veeqo.createOrder
- Create a new orderveeqo.getOrder
- Retrieve order detailsveeqo.listOrders
- List orders with paginationveeqo.updateOrder
- Update existing orderveeqo.deleteOrder
- Delete an orderveeqo.syncInventory
- Sync inventory data
EasyPost Methods
easypost.createShipment
- Create a new shipmenteasypost.getRates
- Get shipping rateseasypost.buyLabel
- Purchase shipping labeleasypost.trackShipment
- Track shipment status
Unified Methods
unified.createOrderWithShipping
- Create order and shipping in one operationunified.processReturn
- Handle return processingunified.bulkOperations
- Batch operations
Web Methods
web.login
- User authenticationweb.getDashboardStats
- Dashboard statisticsweb.searchOrders
- Search orders
Example Request
🔧 Configuration
Docker Configuration
The application includes Docker and Docker Compose configurations for easy deployment:
Dockerfile: Multi-stage build for production optimization
docker-compose.yml: Complete stack with all services
k8s/: Kubernetes manifests for production deployment
Monitoring
Prometheus: Metrics collection and monitoring
Structured Logging: JSON-formatted logs with correlation IDs
Health Checks: Built-in health check endpoints
🧪 Testing
📊 Monitoring
The application includes comprehensive monitoring:
Metrics: Prometheus metrics for all operations
Logging: Structured logging with correlation IDs
Health Checks: Built-in health check endpoints
Error Tracking: Comprehensive error handling and reporting
🔒 Security
JWT Authentication: Secure token-based authentication
Role-based Access: Admin and user role permissions
Input Validation: Comprehensive input validation
Rate Limiting: Built-in rate limiting protection
CORS: Configurable CORS policies
🤝 Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Submit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
For support and questions:
Create an issue in the repository
Check the documentation
Review the test examples
🔄 Version History
v1.0.0 - Initial release with core functionality
Complete MCP server implementation
EasyPost and Veeqo integrations
Web dashboard interface
Docker and Kubernetes deployment ready
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables comprehensive shipping and order management through EasyPost and Veeqo integrations. Supports creating orders, generating shipping labels, tracking shipments, and managing unified workflows with a web-based dashboard interface.