Skip to main content
Glama

Stevia Store MCP Server

by yairbarak22
GitHub
Python
MIT License
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🌿 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

  1. Clone the repository:

    git clone https://github.com/yairbarak22/MCPServerStevia.git cd MCPServerStevia

  2. Install dependencies:

    pip install -r requirements.txt

  3. Initialize the database:

    python scripts/init_database.py

  4. 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.

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📚 Documentation

📞 Support

Need help? We're here for you:

📄 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
A
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.

  1. 🎯 Overview
    1. Key Features
  2. 📋 Product Catalog
    1. 🚀 Quick Start
      1. Prerequisites
      2. Installation
      3. Configuration with Claude Desktop
    2. 🛠️ Available Tools
      1. Product Management
      2. Customer Management
      3. Order Processing
      4. Analytics & Reporting
    3. 💬 Usage Examples
      1. Natural Language Queries
      2. Programmatic Usage
    4. 📁 Project Structure
      1. 🔧 Environment Variables
        1. 🔐 Security Features
          1. 🧪 Testing
            1. 📈 Performance
              1. 🤝 Contributing
                1. 📚 Documentation
                  1. 📞 Support
                    1. 📄 License
                      1. 🌟 About Organital

                        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 -
                          64
                          13
                          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 -
                          64
                          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
                          446
                          2
                          MIT License
                          • Apple

                        • 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 -
                          • Apple

                        View all related MCP servers

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/yairbarak22/MCPServerStevia'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server