🎨 MCP Art Supply Store

Model Context Protocol Server with 36 Business Management Tools

A complete Model Context Protocol (MCP) server for managing an art supply store business with 36 professional tools across 8 categories, plus social media integration.

✨ Features

📦 36 Business Management Tools

🛍️ Inventory Management (5 tools)

• Add/update/remove products
• Check stock levels
• Low stock alerts
• Track product details

👥 Customer Management (4 tools)

• Add/update/retrieve customers
• Customer purchase history
• Loyalty tracking
• Contact management

📝 Order Processing (5 tools)

• Create/update/cancel orders
• Order status tracking
• Order history
• Fulfillment management

💰 Financial Tools (3 tools)

• Sales reports
• Revenue tracking
• Profit analysis

🎨 Art Classes (5 tools)

• Schedule management
• Student enrollment
• Instructor tracking
• Class capacity monitoring

📊 Analytics (4 tools)

• Sales analytics
• Customer insights
• Product performance
• Trend analysis

📢 Marketing (3 tools)

• Campaign management
• Promotion tracking
• Customer targeting

🌐 Social Media (12 tools)

• Facebook post creation
• Instagram publishing
• Post scheduling
• Comment management
• Analytics tracking
• Multi-platform support

🎯 Key Capabilities

• Complete Business Management - All tools for running an art supply store
• Social Media Integration - Facebook & Instagram via Meta Graph API (FREE)
• Real-time Analytics - Track sales, customers, and performance
• Web Dashboard - Beautiful UI for testing and monitoring
• TypeScript - Type-safe, maintainable code
• MCP Protocol - Standard Model Context Protocol implementation

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• (Optional) Facebook/Instagram Business accounts for social media features

Installation

# Clone the repository
git clone https://github.com/wspotter/mcpart.git
cd mcpart

# Install dependencies
npm install

# Build the project
npm run build

# Configure environment (optional - for social media)
cp .env.example .env
# Edit .env with your API keys

Running the Server

As MCP Server:

npm start

With Dashboard:

npm run dashboard
# Open http://localhost:3000

📖 Documentation

Quick Links

• Setup Guide - Installation and configuration
• Tools Documentation - All 36 tools reference
• Facebook/Instagram Setup - Social media integration (500+ lines)
• Integration Guide - Using with Open WebUI
• Quick Reference - Command cheat sheet

Total: 1,500+ lines of documentation

🛠️ Tool Categories

1. Inventory Management

inventory_add_product
inventory_update_product
inventory_remove_product
inventory_check_stock
inventory_list_low_stock

2. Customer Management

customer_add
customer_update
customer_get
customer_list_purchases

3. Order Processing

order_create
order_update
order_cancel
order_get_status
order_list

4. Financial Tools

finance_get_sales_report
finance_get_revenue
finance_get_profit_analysis

5. Art Classes

class_schedule
class_enroll_student
class_list_students
class_get_schedule
class_update_instructor

6. Analytics

analytics_sales_trends
analytics_customer_insights
analytics_product_performance
analytics_monthly_report

7. Marketing

marketing_create_campaign
marketing_track_promotion
marketing_get_customer_segments

8. Social Media (Meta Graph API - FREE!)

social_facebook_create_post
social_instagram_create_post
social_schedule_post
social_get_post_analytics
social_reply_to_comment
social_get_comments
social_delete_post
social_update_post
social_get_page_insights
social_get_instagram_insights
social_upload_media
social_get_scheduled_posts

🎨 Dashboard

Beautiful web interface for testing and monitoring:

Features

• 8 Category Navigation - Organized sidebar
• Tool Cards - Visual tool display with descriptions
• Real-time Testing - Test any tool with JSON input
• Search Functionality - Find tools quickly
• Responsive Design - Works on all devices
• Dark Theme - Easy on the eyes

Access

npm run dashboard
open http://localhost:3000

🌐 Social Media Integration

Facebook & Instagram (FREE!)

Uses Meta Graph API - no cost for basic posting and analytics.

Setup Steps:

1. Create Facebook App
2. Get Page Access Token
3. Configure .env file
4. Connect Instagram Business Account
5. Start posting!

See: FACEBOOK_INSTAGRAM_SETUP.md for detailed guide (500+ lines)

Features:

• Create posts with images
• Schedule future posts
• Monitor comments
• Reply to comments
• Track analytics
• Multi-platform (FB + IG)

📊 Example Usage

Add a Product

{
  "name": "inventory_add_product",
  "arguments": {
    "name": "Acrylic Paint Set",
    "sku": "APS-001",
    "quantity": 50,
    "price": 29.99,
    "category": "Paint",
    "supplier": "ArtPro Inc"
  }
}

Create Facebook Post

{
  "name": "social_facebook_create_post",
  "arguments": {
    "message": "New paint sets just arrived! 🎨",
    "imageUrl": "https://example.com/paint.jpg",
    "link": "https://shop.example.com/paint-sets"
  }
}

Check Sales Report

{
  "name": "finance_get_sales_report",
  "arguments": {
    "startDate": "2025-10-01",
    "endDate": "2025-10-31"
  }
}

🔧 Configuration

Environment Variables

# .env file

# Server
PORT=3000

# Meta Graph API (for social media - optional)
META_ACCESS_TOKEN=your_page_access_token
META_PAGE_ID=your_facebook_page_id
META_INSTAGRAM_ACCOUNT_ID=your_instagram_business_account_id

# API Version
META_API_VERSION=v18.0

MCP Configuration

Add to your MCP client config (e.g., Claude Desktop):

{
  "mcpServers": {
    "art-supply-store": {
      "command": "node",
      "args": ["/path/to/mcpart/build/index.js"],
      "env": {
        "META_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

📁 Project Structure

mcpart/
├── src/
│   ├── index.ts              # Main MCP server
│   ├── dashboard.ts          # Web dashboard server
│   └── social-media.ts       # Social media manager
├── public/
│   ├── index.html            # Dashboard UI
│   ├── styles.css            # Dashboard styling
│   └── script.js             # Dashboard logic
├── build/                    # Compiled TypeScript
├── docs/
│   ├── TOOLS_DOCUMENTATION.md
│   ├── FACEBOOK_INSTAGRAM_SETUP.md
│   └── QUICK_REFERENCE.md
├── .env.example              # Environment template
├── package.json
├── tsconfig.json
└── README.md

🎯 Use Cases

• Art Supply Stores - Complete business management
• Retail Shops - Inventory and sales tracking
• Class Management - Schedule and enrollment
• Social Media Marketing - Automated posting
• Business Analytics - Performance tracking
• Customer Management - Loyalty and history
• AI Assistants - Give AI tools to manage business

🤝 Contributing

Contributions welcome! Areas for improvement:

• [ ] Additional payment integrations
• [ ] Email marketing tools
• [ ] Advanced analytics dashboards
• [ ] Mobile app
• [ ] More social platforms (Twitter, TikTok)
• [ ] Inventory forecasting
• [ ] CRM features

📄 License

MIT License - free to use in your projects!

🙏 Credits

Built with:

• MCP TypeScript SDK - @modelcontextprotocol/sdk
• Meta Graph API - Facebook/Instagram integration
• Express.js - Dashboard server
• TypeScript - Type-safe development

🌟 Star This Repo!

If you find this MCP server useful, please give it a ⭐!

📞 Support

• Documentation: See /docs folder
• Issues: GitHub Issues
• Discussions: GitHub Discussions

🔮 Roadmap

• [x] 24 core business tools
• [x] Social media integration (12 tools)
• [x] Web dashboard
• [x] TypeScript implementation
• [x] Meta Graph API integration
• [ ] Additional social platforms
• [ ] Email marketing
• [ ] Advanced analytics
• [ ] Mobile app
• [ ] Multi-store support

📈 Stats

• 36 Tools across 8 categories
• 1,500+ lines of documentation
• TypeScript for type safety
• Free social media posting
• Production-ready code
• Comprehensive error handling

💼 Perfect For

• Small business owners
• Art supply stores
• Retail shops
• AI assistant developers
• MCP protocol developers
• Social media managers

🎉 Get Started

git clone https://github.com/wspotter/mcpart.git
cd mcpart
npm install
npm run build
npm run dashboard
# Visit http://localhost:3000

---

Version: 1.0
Tools: 36 professional tools
Status: Production-Ready
Created: October 2025

Made with 💚 for the MCP community!

Transform your AI assistant into a complete business management system! 🎨