mcp-zenskar 1.0.13 → 1.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-zenskar",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Model Context Protocol (MCP) server for Zenskar API - customer management, invoicing, and billing operations",
   "main": "src/server.js",
   "bin": {

package/test-mcp.mjs

@@ -1,296 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Server Integration Test
- * Tests the Zenskar MCP server via the actual MCP protocol (stdio transport).
- */
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-
-const ORG_ID = '888ae523-8878-4ed7-85cc-6c0a54320568';
-const API_KEY = 'sandbox_yA9yieTXSqnGxROOoyLMWIP2CTuCm5j_311CVHu16-U';
-
-const userContext = {
-  organization: ORG_ID,
-  authorization: API_KEY,
-};
-
-let client;
-let passed = 0;
-let failed = 0;
-const failures = [];
-
-async function callTool(name, args = {}) {
-  const result = await client.callTool({
-    name,
-    arguments: { ...args, __userContext: userContext },
-  });
-  // MCP returns content array; extract text
-  const text = result.content?.map(c => c.text).join('') || '';
-  const json = (() => { try { return JSON.parse(text); } catch { return null; } })();
-  return { text, json, raw: result };
-}
-
-async function test(label, fn) {
-  try {
-    await fn();
-    passed++;
-    console.log(`  ✅ ${label}`);
-  } catch (err) {
-    failed++;
-    failures.push({ label, error: err.message || String(err) });
-    console.log(`  ❌ ${label}: ${err.message || err}`);
-  }
-}
-
-function assert(cond, msg) {
-  if (!cond) throw new Error(msg);
-}
-
-// ─── MAIN ────────────────────────────────────────────────────
-async function main() {
-  console.log('Starting MCP server via stdio...\n');
-
-  const transport = new StdioClientTransport({
-    command: 'node',
-    args: ['src/server.js'],
-    env: { ...process.env, ZENSKAR_ORGANIZATION: ORG_ID, ZENSKAR_API_KEY: API_KEY },
-  });
-
-  client = new Client({ name: 'test-client', version: '1.0.0' });
-  await client.connect(transport);
-
-  // List available tools
-  const { tools } = await client.listTools();
-  console.log(`MCP server connected. ${tools.length} tools registered.\n`);
-
-  // ─── CUSTOMERS ──────────────────────────────────────────
-  console.log('── Customers ──');
-
-  let customerId;
-  await test('listCustomers (basic)', async () => {
-    const { json } = await callTool('listCustomers', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No results returned');
-    assert(resp.total_count > 0, 'total_count missing');
-    customerId = resp.results[0].id;
-  });
-
-  await test('listCustomers (search field=value)', async () => {
-    const { json } = await callTool('listCustomers', { search: 'customer_name=Star' });
-    const resp = json?.api_response || json;
-    assert(resp?.total_count <= 10, `Expected filtered results, got ${resp?.total_count}`);
-  });
-
-  await test('listCustomers (search_name_external_id)', async () => {
-    const { json } = await callTool('listCustomers', { search_name_external_id: 'Star', limit: 5 });
-    const resp = json?.api_response || json;
-    assert(resp?.total_count <= 10, `Expected filtered results, got ${resp?.total_count}`);
-  });
-
-  await test('getCustomerById', async () => {
-    if (!customerId) throw new Error('No customer ID from previous test');
-    const { json } = await callTool('getCustomerById', { customerId });
-    const resp = json?.api_response || json;
-    assert(resp?.id === customerId, 'ID mismatch');
-  });
-
-  // ─── CONTACTS ──────────────────────────────────────────
-  console.log('\n── Contacts ──');
-
-  let contactId;
-  await test('listContacts', async () => {
-    const { json } = await callTool('listContacts', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No contacts');
-    contactId = resp.results[0].id;
-  });
-
-  await test('getContactById', async () => {
-    if (!contactId) throw new Error('No contact ID');
-    const { json } = await callTool('getContactById', { contactId });
-    const resp = json?.api_response || json;
-    assert(resp?.id === contactId, 'ID mismatch');
-  });
-
-  // ─── INVOICES ──────────────────────────────────────────
-  console.log('\n── Invoices ──');
-
-  let invoiceId;
-  await test('listInvoices (basic)', async () => {
-    const { json } = await callTool('listInvoices', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No invoices');
-    invoiceId = resp.results[0].id;
-  });
-
-  await test('listInvoices (customer_id filter)', async () => {
-    if (!customerId) throw new Error('No customer ID');
-    const { json } = await callTool('listInvoices', { customer_id: customerId, limit: 1 });
-    const resp = json?.api_response || json;
-    // Should filter (may return 0 if customer has no invoices, but should not error)
-    assert(resp?.total_count !== undefined, 'Missing total_count');
-  });
-
-  await test('listInvoices (invoice_total__gte filter)', async () => {
-    const { json } = await callTool('listInvoices', { invoice_total__gte: 100, limit: 1 });
-    const resp = json?.api_response || json;
-    assert(resp?.total_count !== undefined, 'Missing total_count');
-  });
-
-  await test('getInvoiceById', async () => {
-    if (!invoiceId) throw new Error('No invoice ID');
-    const { json } = await callTool('getInvoiceById', { invoiceId });
-    const resp = json?.api_response || json;
-    assert(resp?.id === invoiceId, 'ID mismatch');
-  });
-
-  await test('getInvoiceLineItems', async () => {
-    if (!invoiceId) throw new Error('No invoice ID');
-    const { json } = await callTool('getInvoiceLineItems', { invoiceId });
-    const resp = json?.api_response || json;
-    assert(resp !== null, 'No response');
-  });
-
-  await test('getInvoiceSummary', async () => {
-    if (!invoiceId) throw new Error('No invoice ID');
-    const { json } = await callTool('getInvoiceSummary', { invoiceId });
-    const resp = json?.api_response || json;
-    assert(resp !== null, 'No response');
-  });
-
-  await test('getAllInvoiceTags', async () => {
-    const { json } = await callTool('getAllInvoiceTags');
-    const resp = json?.api_response || json;
-    assert(resp?.tags, 'No tags returned');
-  });
-
-  // ─── PAYMENTS ──────────────────────────────────────────
-  console.log('\n── Payments ──');
-
-  let paymentId;
-  await test('listAllPayments (basic)', async () => {
-    const { json } = await callTool('listAllPayments', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No payments');
-    paymentId = resp.results[0].id;
-  });
-
-  await test('listAllPayments (sort_key + payment_method filter)', async () => {
-    const { json } = await callTool('listAllPayments', { sort_key: 'created_at', sort_type: 'DESC', payment_method: 'bank_transfer', limit: 1 });
-    const resp = json?.api_response || json;
-    assert(resp?.total_count !== undefined, 'Missing total_count');
-  });
-
-  await test('getPaymentById', async () => {
-    if (!paymentId) throw new Error('No payment ID');
-    const { json } = await callTool('getPaymentById', { paymentId });
-    const resp = json?.api_response || json;
-    assert(resp?.id === paymentId, 'ID mismatch');
-  });
-
-  // ─── CONTRACTS ──────────────────────────────────────────
-  console.log('\n── Contracts ──');
-
-  await test('listContracts (basic)', async () => {
-    const { json } = await callTool('listContracts', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No contracts');
-  });
-
-  await test('listContracts (status filter)', async () => {
-    const { json } = await callTool('listContracts', { status: 'active', limit: 1 });
-    const resp = json?.api_response || json;
-    assert(resp?.total_count !== undefined, 'Missing total_count');
-  });
-
-  // ─── AGGREGATES (Billable Metrics) ──────────────────────
-  console.log('\n── Billable Metrics ──');
-
-  let aggregateId;
-  await test('listAggregates', async () => {
-    const { json } = await callTool('listAggregates', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No aggregates');
-    aggregateId = resp.results[0].id;
-  });
-
-  await test('getAggregateById', async () => {
-    if (!aggregateId) throw new Error('No aggregate ID');
-    const { json } = await callTool('getAggregateById', { aggregateId });
-    const resp = json?.api_response || json;
-    assert(resp?.id === aggregateId, 'ID mismatch');
-  });
-
-  await test('getAggregateSchemas', async () => {
-    const { json } = await callTool('getAggregateSchemas');
-    const resp = json?.api_response || json;
-    assert(Array.isArray(resp), 'Expected array of schemas');
-  });
-
-  await test('getAggregateEstimates (snake_case params)', async () => {
-    if (!aggregateId || !customerId) throw new Error('Missing IDs');
-    // This may return 404 domain error (no data) but should NOT 422
-    try {
-      const { json } = await callTool('getAggregateEstimates', {
-        aggregate_id: aggregateId,
-        customer_id: customerId,
-        start_date: '2025-01-01',
-        end_date: '2025-12-31',
-      });
-      // If we get here, great
-    } catch (e) {
-      // 404 domain error is OK (AGGREGATE_ESTIMATE_NOT_FOUND), 422 is NOT
-      if (e.message?.includes('422')) throw new Error('Got 422 — snake_case params not working');
-    }
-  });
-
-  // ─── RAW METRICS ──────────────────────────────────────
-  console.log('\n── Raw Metrics ──');
-
-  let rawMetricSlug;
-  await test('listRawMetrics', async () => {
-    const { json } = await callTool('listRawMetrics', { limit: 2 });
-    const resp = json?.api_response || json;
-    assert(resp?.results?.length > 0, 'No raw metrics');
-    rawMetricSlug = resp.results[0].api_slug;
-  });
-
-  await test('getRawMetricBySlug', async () => {
-    if (!rawMetricSlug) throw new Error('No slug');
-    const { json } = await callTool('getRawMetricBySlug', { rawMetricSlug });
-    const resp = json?.api_response || json;
-    assert(resp?.api_slug === rawMetricSlug, 'Slug mismatch');
-  });
-
-  // ─── OTHER TOOLS ──────────────────────────────────────
-  console.log('\n── Other Tools ──');
-
-  await test('getCurrentDateTime', async () => {
-    const { json } = await callTool('getCurrentDateTime');
-    const resp = json?.api_response || json;
-    assert(resp?.currentDate || resp?.currentDateTime, 'No date returned');
-  });
-
-  await test('getCustomerPortalConfiguration', async () => {
-    const { json } = await callTool('getCustomerPortalConfiguration');
-    const resp = json?.api_response || json;
-    assert(resp !== null, 'No response');
-  });
-
-  // ─── SUMMARY ──────────────────────────────────────────
-  console.log(`\n${'═'.repeat(50)}`);
-  console.log(`RESULTS: ${passed} passed, ${failed} failed out of ${passed + failed} tests`);
-  if (failures.length > 0) {
-    console.log('\nFailed tests:');
-    failures.forEach(f => console.log(`  ❌ ${f.label}: ${f.error}`));
-  }
-  console.log(`${'═'.repeat(50)}\n`);
-
-  await client.close();
-  process.exit(failed > 0 ? 1 : 0);
-}
-
-main().catch(err => {
-  console.error('Fatal error:', err);
-  process.exit(1);
-});