A
security-
licenseA
qualityEnables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.
Last updated -
64
13
MIT License
🌿 Stevia Store MCP Server
A comprehensive Model Context Protocol (MCP) server for managing an organic stevia products e-commerce store. This server enables seamless integration with Claude to provide natural language interfaces for product management, customer service, and order processing.
🎯 Overview
The Stevia Store MCP Server is designed for Organital, a health-focused company specializing in natural stevia-based products. It provides a complete e-commerce backend that can be controlled through natural language using Claude's AI capabilities.
Key Features
🛍️ Product Management - Complete catalog with detailed product information
👥 Customer Management - Customer profiles, preferences, and order history
📦 Inventory Control - Stock tracking with low-inventory alerts
🛒 Order Processing - Full order lifecycle from cart to delivery
📊 Sales Analytics - Comprehensive reporting and insights
🔒 Security Features - Encrypted data and secure payment processing
🌍 Hebrew Language Support - Full RTL support and Hebrew interface
📋 Product Catalog
Our curated selection of premium stevia products:
Product | Price (₪) | Category | Description |
Natural Organic Stevia 100g | 45.90 | Raw Materials | 100% pure organic stevia from Paraguay |
Stevia Tablets (60 units) | 29.90 | Ready Products | Convenient tablets for beverages |
Liquid Stevia Vanilla 50ml | 39.90 | Ready Products | Vanilla-flavored liquid stevia extract |
Baking Stevia Powder 200g | 55.90 | Cooking & Baking | Heat-stable stevia for recipes |
Tasting Bundle (4 types) | 89.90 | Gift Sets | Perfect starter pack with 4 varieties |
🚀 Quick Start
Prerequisites
Python 3.11+
MCP SDK (
pip install mcp)SQLite3
Installation
Clone the repository:
git clone https://github.com/yairbarak22/MCPServerStevia.git cd MCPServerSteviaInstall dependencies:
pip install -r requirements.txtInitialize the database:
python scripts/init_database.pyStart the server:
python src/stevia_store_server.py
Configuration with Claude Desktop
Add this configuration to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"stevia-store": {
"command": "python",
"args": ["path/to/MCPServerStevia/src/stevia_store_server.py"],
"env": {
"DATABASE_PATH": "path/to/your/stevia_store.db"
}
}
}
}
🛠️ Available Tools
The server provides these MCP tools for natural language interaction:
Product Management
add_product- Add new products to the catalogget_products- List products with filtering optionsupdate_inventory- Manage stock levelsget_low_stock_alerts- Monitor inventory warnings
Customer Management
add_customer- Register new customersget_customer_profile- Access customer informationupdate_customer_info- Modify customer details
Order Processing
create_order- Process new orderstrack_order- Monitor order statuscalculate_cart_total- Compute order totals
Analytics & Reporting
get_sales_summary- Generate sales reportsget_product_performance- Analyze product metricsget_customer_insights- Customer behavior analysis
💬 Usage Examples
Natural Language Queries
Product Information:
"Show me all stevia products under 40 shekels"
Inventory Management:
"Which products are running low on stock?"
Customer Service:
"Create an order for customer ID 5 with 2 stevia tablets and 1 liquid vanilla"
Sales Analysis:
"What were our top selling products last month?"
Programmatic Usage
import asyncio
from mcp.client import stdio_client
async def get_products():
async with stdio_client("python", ["src/stevia_store_server.py"]) as client:
result = await client.call_tool("get_products", {})
return result
# Run the async function
products = asyncio.run(get_products())
print(products)
📁 Project Structure
MCPServerStevia/
├── README.md # This file
├── requirements.txt # Python dependencies
├── .gitignore # Git ignore rules
├── src/ # Source code
│ ├── stevia_store_server.py # Basic MCP server
│ ├── complete_stevia_store.py # Full-featured server
│ └── secure_stevia_store.py # Enterprise security version
├── docs/ # Documentation
│ ├── API.md # API documentation
│ ├── installation.md # Setup instructions
│ └── stevia-products-spec.md # Product specifications
├── examples/ # Usage examples
│ ├── sample_usage.py # Basic usage examples
│ └── sample_data.json # Sample product data
├── scripts/ # Utility scripts
│ └── init_database.py # Database setup
└── tests/ # Test files
└── test_server.py # Unit tests
🔧 Environment Variables
Configure the server using these environment variables:
Variable | Default | Description |
|
| SQLite database file path |
|
| Server port for HTTP transport |
|
| Key for sensitive data encryption |
|
| Logging verbosity level |
🔐 Security Features
🔒 Data Encryption - Sensitive customer data is encrypted at rest
🛡️ Input Validation - All inputs are sanitized and validated
🔐 Access Control - Role-based permissions system
📝 Audit Logging - Complete activity logs for compliance
🚫 SQL Injection Protection - Parameterized queries only
🧪 Testing
Run the test suite:
# Run all tests
python -m pytest tests/
# Run with coverage
python -m pytest tests/ --cov=src
# Run specific test
python -m pytest tests/test_server.py::test_add_product
📈 Performance
The server is optimized for:
10,000+ concurrent users
Sub-200ms response times
99.9% uptime availability
Automatic database optimization
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines for details.
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
📚 Documentation
API Reference - Complete API documentation
Installation Guide - Detailed setup instructions
Product Specifications - Product catalog details
MCP Protocol Guide - Official MCP documentation
📞 Support
Need help? We're here for you:
📧 Email: support@organital.co.il
🐛 Bug Reports: GitHub Issues
💬 Discussions: GitHub Discussions
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🌟 About Organital
Organital is Israel's leading provider of natural stevia products, committed to promoting healthy living through pure, organic sweetening solutions. Our products are:
✅ 100% Natural - No artificial additives
🌱 Organic Certified - Sustainably sourced
💚 Health Focused - Zero calories, diabetic-friendly
🏅 Premium Quality - Rigorous quality control
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables managing an organic stevia products e-commerce store through natural language, including product catalog management, customer service, order processing, and sales analytics. Provides a complete backend for Organital's stevia business with Hebrew language support.
Related MCP Servers
- Asecurity-licenseAqualityEnables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.Last updated -6430MIT License
- Asecurity-licenseAqualityEnables interaction with Shopify store data through GraphQL API, providing tools for managing products, customers, orders, blogs, and articles.Last updated -154462MIT License
- -security-license-qualityEnables natural language database operations and semantic document search through SQLite and vector database integration. Converts plain English instructions into SQL queries and provides RAG capabilities for uploaded documents.Last updated -