npm - circuit-mcp - Versions diffs - 1.0.7 → 1.0.10 - Mend

circuit-mcp 1.0.7 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "circuit-mcp",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "Circuit MCP server for Cursor and Claude Code",
   "type": "module",
   "bin": {

package/src/auth.js CHANGED Viewed

@@ -148,39 +148,69 @@ function getSuccessPage() {
       justify-content: center;
       color: #1C1A18;
     }
-    .container {
+    .card {
+      background: white;
+      border-radius: 16px;
+      box-shadow: 0 4px 24px rgba(0,0,0,0.08);
+      padding: 48px 64px;
       text-align: center;
-      padding: 48px;
+      max-width: 420px;
     }
-    .icon {
-      font-size: 48px;
-      margin-bottom: 24px;
+    .logo {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      gap: 8px;
+      margin-bottom: 32px;
+    }
+    .logo-icon {
+      width: 28px;
+      height: 28px;
+      background: #1C1A18;
+      border-radius: 50%;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+    }
+    .logo-icon::after {
+      content: '';
+      width: 12px;
+      height: 12px;
+      border: 2px solid white;
+      border-radius: 50%;
+    }
+    .logo-text {
+      font-size: 16px;
+      font-weight: 500;
+    }
+    .woo {
+      font-size: 14px;
+      color: rgba(28,26,24,0.5);
+      margin-bottom: 8px;
     }
     h1 {
-      font-size: 24px;
+      font-size: 28px;
       font-weight: 600;
-      margin-bottom: 16px;
+      margin-bottom: 12px;
     }
     p {
-      font-size: 16px;
+      font-size: 15px;
       color: rgba(28,26,24,0.6);
-      margin-bottom: 8px;
-    }
-    .hint {
-      margin-top: 24px;
-      font-size: 14px;
-      color: rgba(28,26,24,0.4);
+      line-height: 1.5;
     }
   </style>
 </head>
 <body>
-  <div class="container">
-    <div class="icon">◉</div>
+  <div class="card">
+    <div class="logo">
+      <div class="logo-icon"></div>
+      <span class="logo-text">Circuit</span>
+    </div>
+    <p class="woo">Woo hoo!</p>
     <h1>Connected to Circuit</h1>
-    <p>You can close this window.</p>
-    <p class="hint">Return to your terminal to continue.</p>
+    <p>You can close this window to continue Circuiting.</p>
   </div>
-  <script>setTimeout(() => window.close(), 2000);</script>
+  <script>setTimeout(() => window.close(), 3000);</script>
 </body>
 </html>`;
 }

package/src/index.js CHANGED Viewed

@@ -1,4 +1,9 @@
 import chalk from 'chalk';
+import readline from 'readline';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
 import { authenticate, getStoredToken } from './auth.js';
 import { startMcpServer } from './server.js';
 import { showBanner, showSuccess, showError, showSpinner } from './ui.js';
@@ -47,7 +52,7 @@ function showHelp() {
   console.log(chalk.white.bold('  Commands:\n'));
   console.log(`  ${chalk.cyan('npx circuit-mcp')}          Start MCP server`);
-  console.log(`  ${chalk.cyan('npx circuit-mcp setup')}    Show setup instructions`);
+  console.log(`  ${chalk.cyan('npx circuit-mcp setup')}    Configure Cursor or Claude Code`);
   console.log(`  ${chalk.cyan('npx circuit-mcp auth')}     Re-authenticate`);
   console.log(`  ${chalk.cyan('npx circuit-mcp logout')}   Clear stored token`);
   console.log(`  ${chalk.cyan('npx circuit-mcp fix')}      Troubleshooting guide`);
@@ -110,34 +115,170 @@ function showTroubleshoot() {
   console.log(chalk.dim('  Or visit: https://withcircuit.com/help\n'));
 }
+// Helper to prompt user for input
+function prompt(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+function showUsageGuide() {
+  console.log(chalk.dim('  ─────────────────────────────────────────\n'));
+  console.log(chalk.white.bold('  How to use Circuit\n'));
+  console.log(chalk.dim('  Open Claude Code or Cursor and ask:\n'));
+  console.log(chalk.white('  "What are my top priorities?"'));
+  console.log(chalk.white('  "Show me the brief for priority #1"'));
+  console.log(chalk.white('  "What feedback mentions dark mode?"'));
+  console.log(chalk.white('  "What are my most urgent issues?"'));
+  console.log(chalk.white('  "Show priorities by revenue impact"'));
+  console.log();
+  console.log(chalk.dim('  Circuit will fetch your real customer data.'));
+  console.log(chalk.dim('  Just ask naturally and your AI will handle the rest.\n'));
+}
+// Configure Cursor by writing to ~/.cursor/mcp.json
+async function configureCursor() {
+  const configPath = path.join(os.homedir(), '.cursor', 'mcp.json');
+  const circuitConfig = {
+    command: 'npx',
+    args: ['circuit-mcp']
+  };
+  try {
+    // Ensure .cursor directory exists
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    let config = { mcpServers: {} };
+    // Try to read existing config
+    try {
+      const existing = await fs.readFile(configPath, 'utf-8');
+      config = JSON.parse(existing);
+      if (!config.mcpServers) {
+        config.mcpServers = {};
+      }
+    } catch {
+      // File doesn't exist, use default
+    }
+    // Add Circuit
+    config.mcpServers.circuit = circuitConfig;
+    // Write config
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+// Configure Claude Code by running the CLI command
+function configureClaudeCode() {
+  try {
+    execSync('claude mcp add circuit -- npx circuit-mcp', {
+      stdio: 'pipe',
+      timeout: 10000
+    });
+    return true;
+  } catch (err) {
+    // Command might fail if claude CLI not installed
+    return false;
+  }
+}
 async function runSetup() {
   showBanner();
   console.log(chalk.white.bold('  Welcome to Circuit!\n'));
-  console.log(chalk.dim('  Connect your AI coding tool to start building from customer feedback.\n'));
+  console.log(chalk.dim('  Let\'s connect Circuit to your AI coding tool.\n'));
   console.log(chalk.dim('  ─────────────────────────────────────────\n'));
-  console.log(chalk.cyan.bold('  Cursor\n'));
-  console.log(chalk.dim('  1. Open your MCP config file:\n'));
-  console.log(chalk.white('     open ~/.cursor/mcp.json\n'));
-  console.log(chalk.dim('  2. Add this to the file:\n'));
-  console.log(chalk.white(`     {
+  console.log(chalk.white('  Which tool are you using?\n'));
+  console.log(chalk.white('  1. Cursor'));
+  console.log(chalk.white('  2. Claude Code'));
+  console.log(chalk.dim('  3. Both\n'));
+  const choice = await prompt(chalk.cyan('  Enter 1, 2, or 3: '));
+  console.log();
+  if (choice === '1' || choice === '3') {
+    console.log(chalk.dim('  Setting up Cursor...\n'));
+    const success = await configureCursor();
+    if (success) {
+      showSuccess('Added Circuit to ~/.cursor/mcp.json');
+      console.log(chalk.dim('     Restart Cursor to activate.\n'));
+    } else {
+      showError('Could not update Cursor config automatically.');
+      console.log(chalk.dim('     Add this to ~/.cursor/mcp.json manually:\n'));
+      console.log(chalk.white(`     {
        "mcpServers": {
-         "circuit": {
-           "command": "npx",
-           "args": ["circuit-mcp"]
-         }
+         "circuit": { "command": "npx", "args": ["circuit-mcp"] }
        }
      }\n`));
-  console.log(chalk.dim('  3. Restart Cursor\n'));
+    }
+  }
-  console.log(chalk.cyan.bold('  Claude Code\n'));
-  console.log(chalk.dim('  Run this in your terminal:\n'));
-  console.log(chalk.white('     claude mcp add circuit -- npx circuit-mcp\n'));
+  if (choice === '2' || choice === '3') {
+    console.log(chalk.dim('  Setting up Claude Code...\n'));
+    const success = configureClaudeCode();
+    if (success) {
+      showSuccess('Added Circuit to Claude Code');
+      console.log(chalk.dim('     Restart Claude Code to activate.\n'));
+    } else {
+      showError('Could not run claude CLI automatically.');
+      console.log(chalk.dim('     Run this command manually:\n'));
+      console.log(chalk.white('     claude mcp add circuit -- npx circuit-mcp\n'));
+    }
+  }
+  if (!['1', '2', '3'].includes(choice)) {
+    console.log(chalk.dim('  No worries! Here are the manual steps:\n'));
+    console.log(chalk.cyan.bold('  Cursor'));
+    console.log(chalk.dim('  Add to ~/.cursor/mcp.json:'));
+    console.log(chalk.white('  { "mcpServers": { "circuit": { "command": "npx", "args": ["circuit-mcp"] } } }\n'));
+    console.log(chalk.cyan.bold('  Claude Code'));
+    console.log(chalk.dim('  Run:'));
+    console.log(chalk.white('  claude mcp add circuit -- npx circuit-mcp\n'));
+    return;
+  }
+  console.log(chalk.dim('  ─────────────────────────────────────────\n'));
+  console.log(chalk.white.bold('  Almost done!\n'));
+  console.log(chalk.dim('  Now let\'s connect your Circuit account.\n'));
+  const authChoice = await prompt(chalk.cyan('  Sign in now? (Y/n): '));
+  if (authChoice.toLowerCase() !== 'n') {
+    console.log();
+    console.log(chalk.dim('  Opening browser to sign in...\n'));
+    try {
+      const token = await authenticate();
+      showSuccess('Signed in to Circuit');
+      console.log();
+    } catch (err) {
+      showError('Could not sign in automatically.');
+      console.log(chalk.dim('     Run this later: npx circuit-mcp auth\n'));
+    }
+  }
   console.log(chalk.dim('  ─────────────────────────────────────────\n'));
-  console.log(chalk.dim('  Circuit will prompt you to sign in on first use.\n'));
+  console.log(chalk.white.bold('  You\'re all set!\n'));
+  console.log(chalk.dim('  Restart your editor and start using Circuit.\n'));
+  showUsageGuide();
 }
 async function runAuth() {
@@ -150,6 +291,7 @@ async function runAuth() {
     spinner.stop();
     showSuccess('Authenticated successfully!');
     console.log(chalk.dim('\n  Your token is stored locally.\n'));
+    showUsageGuide();
   } catch (err) {
     spinner.stop();
     showError(`Authentication failed: ${err.message}`);

package/src/server.js CHANGED Viewed

@@ -35,6 +35,30 @@ export async function startMcpServer(token) {
   process.stdin.resume();
 }
+/**
+ * Call Circuit MCP backend API
+ */
+async function callMcpApi(token, toolName, args = {}) {
+  const response = await fetch(`${CIRCUIT_API}/mcp/call`, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${token}`,
+      'Content-Type': 'application/json'
+    },
+    body: JSON.stringify({
+      tool: toolName,
+      arguments: args
+    })
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`API error ${response.status}: ${text}`);
+  }
+  return response.json();
+}
 /**
  * Handle incoming MCP message
  */
@@ -71,47 +95,83 @@ async function handleMessage(message, token) {
           tools: [
             {
               name: 'get_priorities',
-              description: 'Get the top customer feedback priorities from Circuit',
+              description: 'Get your top priorities from Circuit, ranked by customer volume. These are the features/fixes that matter most to your users.',
               inputSchema: {
                 type: 'object',
                 properties: {
                   limit: {
                     type: 'number',
-                    description: 'Maximum number of priorities to return (default: 10)'
+                    description: 'Number of priorities to return (default: 5, max: 20)'
                   },
-                  focus: {
+                  sort_by: {
                     type: 'string',
-                    description: 'Focus type: volume, revenue, urgency, negative, positive, feature',
-                    enum: ['volume', 'revenue', 'urgency', 'negative', 'positive', 'feature']
+                    description: 'Sort criterion: volume, urgency, revenue, negative, positive',
+                    enum: ['volume', 'urgency', 'revenue', 'negative', 'positive']
                   }
                 }
               }
             },
             {
               name: 'get_brief',
-              description: 'Get the engineering brief for a specific priority',
+              description: 'Get the full engineering brief for a specific priority. Includes what to build, why it matters, customer quotes, files to touch, and done criteria.',
               inputSchema: {
                 type: 'object',
                 properties: {
                   priority_id: {
                     type: 'string',
-                    description: 'The ID of the priority to get the brief for'
+                    description: 'The priority ID (from get_priorities)'
+                  },
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID directly (alternative to priority_id)'
+                  }
+                }
+              }
+            },
+            {
+              name: 'start_building',
+              description: "Mark a brief as 'building' - you're actively working on this feature.",
+              inputSchema: {
+                type: 'object',
+                properties: {
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID to mark as building'
+                  }
+                },
+                required: ['build_id']
+              }
+            },
+            {
+              name: 'mark_done',
+              description: "Mark a brief as 'done' - the feature has shipped! This closes the feedback loop.",
+              inputSchema: {
+                type: 'object',
+                properties: {
+                  build_id: {
+                    type: 'string',
+                    description: 'The build ID to mark as done'
                   }
                 },
-                required: ['priority_id']
+                required: ['build_id']
               }
             },
             {
-              name: 'get_feedback',
-              description: 'Get raw customer feedback items',
+              name: 'search_feedback',
+              description: 'Search customer feedback by keyword. Useful for understanding pain points around specific features.',
               inputSchema: {
                 type: 'object',
                 properties: {
+                  query: {
+                    type: 'string',
+                    description: 'Search query (keywords or phrase)'
+                  },
                   limit: {
                     type: 'number',
-                    description: 'Maximum number of feedback items to return (default: 20)'
+                    description: 'Max results (default: 10)'
                   }
-                }
+                },
+                required: ['query']
               }
             }
           ]
@@ -151,28 +211,8 @@ async function handleToolCall(id, params, token) {
   const { name, arguments: args } = params;
   try {
-    let result;
-    switch (name) {
-      case 'get_priorities':
-        result = await fetchPriorities(token, args);
-        break;
-      case 'get_brief':
-        result = await fetchBrief(token, args);
-        break;
-      case 'get_feedback':
-        result = await fetchFeedback(token, args);
-        break;
-      default:
-        return {
-          jsonrpc: '2.0',
-          id,
-          error: { code: -32602, message: `Unknown tool: ${name}` }
-        };
-    }
+    // Call the Circuit MCP backend
+    const result = await callMcpApi(token, name, args || {});
     return {
       jsonrpc: '2.0',
@@ -191,96 +231,3 @@ async function handleToolCall(id, params, token) {
   }
 }
-/**
- * Fetch priorities from Circuit API
- */
-async function fetchPriorities(token, args = {}) {
-  const limit = args.limit || 10;
-  const focus = args.focus || 'volume';
-  const url = `${CIRCUIT_API}/api/focus?limit=${limit}&focus_type=${focus}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  // Format for readability
-  return (data.priorities || data.clusters || []).map((p, i) => ({
-    rank: i + 1,
-    id: p.cluster_id || p.id,
-    title: p.summary || p.theme,
-    category: p.category,
-    mentions: p.volume || p.count,
-    urgency: p.urgency_score,
-    trend: p.trend
-  }));
-}
-/**
- * Fetch a specific brief from Circuit API
- */
-async function fetchBrief(token, args) {
-  if (!args.priority_id) {
-    throw new Error('priority_id is required');
-  }
-  const url = `${CIRCUIT_API}/api/builds?cluster_id=${args.priority_id}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  const build = (data.builds || []).find(b =>
-    b.cluster_id === args.priority_id || b.clusterId === args.priority_id
-  );
-  if (!build) {
-    throw new Error('Brief not found for this priority');
-  }
-  return {
-    id: build.id,
-    title: build.title,
-    status: build.status,
-    content: build.build || build.spec_content
-  };
-}
-/**
- * Fetch raw feedback from Circuit API
- */
-async function fetchFeedback(token, args = {}) {
-  const limit = args.limit || 20;
-  const url = `${CIRCUIT_API}/api/feedback/all?limit=${limit}`;
-  const response = await fetch(url, {
-    headers: { 'Authorization': `Bearer ${token}` }
-  });
-  if (!response.ok) {
-    throw new Error(`API error: ${response.status}`);
-  }
-  const data = await response.json();
-  return (data.feedback || []).map(f => ({
-    id: f.id,
-    text: f.text,
-    source: f.source,
-    sentiment: f.analysis?.sentiment,
-    intent: f.analysis?.intent,
-    created_at: f.created_at
-  }));
-}