MCP Server Demo Guide

This guide provides step-by-step instructions for demonstrating the Eryxon Flow MCP Server capabilities.

Prerequisites

Before the demo, ensure you have:

Environment Variables Set

export SUPABASE_URL="https://your-project.supabase.co"
export SUPABASE_SERVICE_KEY="your-service-key"
export OPENAI_API_KEY="sk-..."  # Optional, for AI chat features

Server Built and Ready
Terminal window
```
cd mcp-server
npm install
npm run build
```
Sample Data - Ensure your Supabase database has some sample jobs, parts, and operations for demonstration.

Quick Start

Start the MCP Server

npm start

npm run dev

You should see:

Eryxon Flow MCP Server v2.3.0
Loaded 55 tools from 10 modules
Eryxon Flow MCP Server running on stdio

Configure Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "eryxon-flow": {
      "command": "node",
      "args": ["/path/to/eryxon-flow/mcp-server/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SERVICE_KEY": "your-service-key"
      }
    }
  }
}

Demo Scenarios

Scenario 1: Basic Job Management (5 min)

Objective: Show basic CRUD operations for manufacturing jobs.

Fetch Current Jobs
```
"Show me all jobs currently in progress"
```
The AI will use fetch_jobs with status: "in_progress".

Create a New Job

"Create a new job for customer 'Acme Corp' with job number 'JOB-2024-0042' due next Friday"

Uses create_job tool.

Update Job Priority

"Change job JOB-2024-0042 to high priority"

Uses update_job tool.

Start the Job
```
"Start job JOB-2024-0042"
```
Uses start_job tool.

Scenario 2: Production Dashboard (3 min)

Objective: Demonstrate real-time production metrics.

Get Dashboard Stats

"Show me the current production dashboard stats"

Uses get_dashboard_stats.

View QRM Capacity

"What's our current cell capacity utilization?"

Uses get_qrm_data.

Production Metrics

"Show me production metrics for the last 7 days"

Uses get_production_metrics.

Scenario 3: AI-Powered Analysis (5 min)

Objective: Showcase natural language AI capabilities.

Ask a Natural Language Question
```
"What are the most common quality issues we've seen this month?"
```
Uses chat_query with context: “quality”.

Get Job Summary

"Give me an AI summary of our job status focusing on any delays"

Uses chat_summarize_jobs with focus: “delays”.

Quality Analysis
```
"Analyze our quality issues and give me recommendations"
```
Uses chat_analyze_quality with include_recommendations: true.
Get Action Suggestions
```
"What actions should we take to address bottlenecks?"
```
Uses chat_suggest_actions with focus_area: “bottlenecks”.

Scenario 4: Rush Order Handling (5 min)

Objective: Demonstrate agent batch operations for handling urgent orders.

Prioritize a Rush Job

"We have a rush order from customer 'Premium Parts Inc'.
Prioritize job JOB-2024-0035, mark all parts as bullet cards,
and add a note about the customer's deadline."

Uses prioritize_job.

Check Resource Availability
```
"What machines are available to work on this rush job?"
```
Uses check_resource_availability.
Get Parts Due Soon
```
"What parts are due in the next 3 days?"
```
Uses get_parts_due_soon.

Suggest Reschedule

"Suggest a reschedule plan to accommodate this rush order"

Uses suggest_reschedule.

Scenario 5: ERP Integration (5 min)

Objective: Show bidirectional sync with external ERP systems.

Check Sync Differences

"Compare our current jobs with this ERP data and show me the differences:
[
  { external_id: 'SAP-123', external_source: 'SAP', job_number: 'JOB-001', customer: 'Acme' },
  { external_id: 'SAP-124', external_source: 'SAP', job_number: 'JOB-002', customer: 'Beta Corp' }
]"

Uses erp_sync_diff.

Lookup External ID

"Find the local job for SAP external ID 'SAP-123'"

Uses erp_lookup_external_id.

Execute Sync

"Sync this ERP data with our system, skipping unchanged records"

Uses erp_sync_execute.

Scenario 6: Shipping & Logistics (5 min)

Objective: Demonstrate shipping management capabilities.

Check Jobs Ready for Shipping
```
"What jobs are ready to be shipped?"
```
Uses get_jobs_ready_for_shipping.

Get Shipping Status

"Show me all pending shipments for customer 'Acme Corp'"

Uses get_shipping_status.

Find Consolidation Opportunities

"Find opportunities to consolidate shipments going to the same destination"

Uses find_shipping_consolidation.

Plan Shipping

"Plan shipping for jobs JOB-001 and JOB-002, consolidating where possible"

Uses plan_shipping.

Scenario 7: Operations Management (5 min)

Objective: Show granular operation control.

Fetch Operations

"Show me all operations for job JOB-2024-0035"

Uses fetch_operations.

Start an Operation
```
"Start the laser cutting operation"
```
Uses start_operation.
Complete Multiple Operations
```
"Complete operations OP-001 and OP-002"
```
Uses batch_complete_operations.

Assign Resources

"Assign Machine #3 to operations OP-003 and OP-004"

Uses assign_resource_to_operations.

Scenario 8: Quality & NCR Management (5 min)

Objective: Demonstrate issue tracking and NCR workflow.

Fetch Open Issues
```
"Show me all critical issues that are currently open"
```
Uses fetch_issues with severity: “critical”, status: “open”.

Create an NCR

"Create a Non-Conformance Report for operation OP-005:
- Title: 'Dimensional out of tolerance'
- Severity: high
- Category: process
- Description: 'Part dimensions exceed tolerance by 0.5mm'"

Uses create_ncr.

Update Issue Status
```
"Mark issue ISS-001 as resolved"
```
Uses update_issue.

Troubleshooting

Server Won’t Start

echo $SUPABASE_URL
echo $SUPABASE_SERVICE_KEY


npm run build


npm start 2>&1 | head -20

Tools Not Appearing in Claude

Restart Claude Desktop
Check the MCP configuration file syntax
Verify the path to dist/index.js is correct
Check Claude Desktop logs

Database Connection Errors

node -e "
const { createClient } = require('@supabase/supabase-js');
const supabase = createClient(process.env.SUPABASE_URL, process.env.SUPABASE_SERVICE_KEY);
supabase.from('jobs').select('count').single().then(console.log);
"