Stevia Store MCP Server

🌿 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 MCPServerStevia
Install dependencies:
pip install -r requirements.txt
Initialize the database:
python scripts/init_database.py
Start 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 catalog
get_products - List products with filtering options
update_inventory - Manage stock levels
get_low_stock_alerts - Monitor inventory warnings

Customer Management

add_customer - Register new customers
get_customer_profile - Access customer information
update_customer_info - Modify customer details

Order Processing

create_order - Process new orders
track_order - Monitor order status
calculate_cart_total - Compute order totals

Analytics & Reporting

get_sales_summary - Generate sales reports
get_product_performance - Analyze product metrics
get_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
`DATABASE_PATH`	`stevia_store.db`	SQLite database file path
`MCP_SERVER_PORT`	`3000`	Server port for HTTP transport
`ENCRYPTION_KEY`	`None`	Key for sensitive data encryption
`LOG_LEVEL`	`INFO`	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

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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

Shopify MCP Server
amir-bengherbi
A
security
A
license
A
quality
Enables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.
Last updated -
51
12
MIT License
Shopify MCP Server
rezapex
A
security
A
license
A
quality
Enables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.
Last updated -
51
30
MIT License
Shopify MCP Server
luckyfarnon
A
security
A
license
A
quality
Enables interaction with Shopify store data through GraphQL API, providing tools for managing products, customers, orders, blogs, and articles.
Last updated -
15
363
2
MIT License
AnyDB MCP Server
iamayuppie
-
security
F
license
-
quality
Enables 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 -

View all related MCP servers

Stevia Store MCP Server