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.