Testing

✅ Quick Test Results

Your MCP server is fully functional! All 11 tools tested successfully:

  • ✅ search_vcons

  • ✅ get_vcon

  • ✅ create_vcon

  • ✅ add_dialog

  • ✅ add_analysis

  • ✅ add_attachment

  • ✅ delete_vcon

  • ✅ update_vcon

  • ✅ create_vcon_from_template

  • ✅ get_schema

  • ✅ get_examples

🔧 Three Ways to Test

Option 1: MCP Inspector (Best for Development) 🎯

The MCP Inspector provides a GUI for testing your server.

Start the Inspector:

# Using npm script (recommended)
npm run test:console

# Or directly with npx
npx @modelcontextprotocol/inspector tsx src/index.ts

Then open http://localhost:5173 in your browser.

What you can do:

  • Browse available tools visually

  • Test each tool with form inputs

  • See real-time request/response logs

  • Debug tool parameters and results

Try these in the Inspector:

  1. search_vcons

    {
  "subject": "Chevrolet",
  "limit": 5
}

  2. get_vcon

    {
  "uuid": "01f344c1-02c2-478f-9441-f25bdc85bdaf"
}

Option 2: Claude Desktop (Best for Real Usage) 💬

Integrate your MCP server directly with Claude Desktop.

Setup Steps:

  1. Copy the config file:

    cp /Users/thomashowe/Documents/GitHub/vcon-mcp/claude-desktop-config.json \
   ~/Library/Application\ Support/Claude/claude_desktop_config.json

  2. Restart Claude Desktop

  3. Verify it loaded:

    • Look for the 🔌 MCP icon in Claude Desktop

    • It should show "vcon" as an available server

    • You should see 11 tools available

Test in Claude:

Try asking Claude:

  • "Search for vCons about Chevrolet vehicles"

  • "Get the vCon with UUID 01f344c1-02c2-478f-9441-f25bdc85bdaf"

  • "Show me conversations from today"

  • "Create a new vCon for a customer support call"

Example prompts:

"Find all conversations mentioning Nissan from the last week"

"Get the full details of vCon 01f344c1-02c2-478f-9441-f25bdc85bdaf 
and summarize the conversation"

"Create a new vCon for a customer service call between an agent 
named Alice and a customer named Bob about a product inquiry"

"Add sentiment analysis to vCon 01f344c1-02c2-478f-9441-f25bdc85bdaf 
showing positive sentiment with score 0.85"

Option 3: Direct Script Testing (Best for Automation) 🤖

Run the test script directly to verify all functionality.

Run tests:

cd /Users/thomashowe/Documents/GitHub/vcon-mcp
npx tsx scripts/test-mcp-tools.ts

Unit test suite

Run the Vitest suite (includes search RPC method tests):

npm test

Relevant files:

  • tests/search.test.ts – RPC wiring for keyword, semantic, hybrid search

What it tests:

  1. ✅ Search vCons by subject

  2. ✅ Retrieve full vCon with all relationships

  3. ✅ Create new vCon with parties

  4. ✅ Add dialog to vCon

  5. ✅ Add AI analysis

  6. ✅ Add attachments

  7. ✅ Search by party

  8. ✅ Delete vCon

Output shows:

  • Each test step with results

  • Actual data from your database

  • Success/failure status

  • Complete validation

📊 Sample Test Data

Your database has real production data:

Example vCon UUIDs to test with:

01f344c1-02c2-478f-9441-f25bdc85bdaf  - Chevrolet Silverado inquiry
ac8b993d-f67d-4579-8d38-63e56b71234a  - Champion Chevrolet GMC
554f6095-8b89-40a6-9103-64d905b5b385  - Pride Chevrolet
002c489d-3eec-4596-bc72-da4eb3b05caa  - Burleson Nissan reservation

Sample Queries:

Search by subject:

{
  "subject": "Chevrolet",
  "limit": 10
}

Search by party:

{
  "party_name": "Denis Duarte",
  "limit": 5
}

Date range search:

{
  "start_date": "2025-08-01",
  "end_date": "2025-09-01",
  "limit": 20
}

🎯 Recommended Testing Flow

1. Quick Validation (2 minutes)

npx tsx scripts/test-mcp-tools.ts

✅ Confirms all tools work

2. Interactive Testing (10 minutes)

npm run test:console

  • Open http://localhost:5173

  • Test each tool manually

  • Experiment with different parameters

3. Real Usage (ongoing)

  • Set up Claude Desktop integration

  • Use natural language to interact with vCons

  • Build workflows with AI assistance

🔍 Debugging

View Server Logs

# Find the dev server process
ps aux | grep "tsx watch"

# Server logs appear in the terminal where you ran `npm run dev`

Database Queries

# Connect to database
psql postgresql://postgres:[email protected]:54322/postgres

# Useful queries
SELECT COUNT(*) FROM vcons;
SELECT uuid, subject FROM vcons LIMIT 5;
SELECT * FROM parties WHERE name ILIKE '%customer%';

Check Supabase Status

supabase status

🚀 Advanced Testing

Load Testing

Create a script to generate many vCons:

for i in {1..100}; do
  npx tsx -e "
    import { getSupabaseClient } from './src/db/client.js';
    import { VConQueries } from './src/db/queries.js';
    const supabase = getSupabaseClient();
    const queries = new VConQueries(supabase);
    await queries.createVCon({
      vcon: '0.3.0',
      uuid: crypto.randomUUID(),
      created_at: new Date().toISOString(),
      subject: 'Load Test vCon $i',
      parties: [{ name: 'Test User' }]
    });
  "
done

Integration Testing

Test with external systems:

// Example: Test with webhook
const result = await fetch('YOUR_WEBHOOK_URL', {
  method: 'POST',
  body: JSON.stringify({
    tool: 'search_vcons',
    params: { subject: 'test' }
  })
});

📝 Test Checklist

Before deploying:

🎉 You're Ready!

Your MCP server is fully tested and operational. Choose your preferred testing method:

  • Quick validation: Run npx tsx scripts/test-mcp-tools.ts

  • Interactive testing: Use MCP Inspector

  • Production usage: Integrate with Claude Desktop

All 4,443 production vCons are loaded and accessible!

PreviousPlugin DevelopmentNextEmbeddings

Last updated