🎨 MCP Art Supply Store

Model Context Protocol Server with 36 Business Management Tools

TypeScript MCP Node.js

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:

Create Facebook App
Get Page Access Token
Configure .env file
Connect Instagram Business Account
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

24 core business tools
Social media integration (12 tools)
Web dashboard
TypeScript implementation
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! 🎨