@stacksfinder/mcp-server 1.0.2 → 1.2.0

package/dist/lib/mcp-compatibility/utils.js

@@ -0,0 +1,269 @@
+/**
+ * MCP Compatibility Utilities
+ *
+ * Canonical matching utilities for consistent MCP identification.
+ */
+/**
+ * Aliases map for common MCP name variations.
+ * Keys are normalized (lowercase, trimmed), values are canonical IDs.
+ */
+export const MCP_ALIASES = {
+    // Database MCPs
+    supabase: 'supabase-mcp',
+    '@supabase/mcp': 'supabase-mcp',
+    '@supabase/mcp-server': 'supabase-mcp',
+    neon: 'neon-mcp',
+    '@neondatabase/mcp': 'neon-mcp',
+    '@neondatabase/mcp-server': 'neon-mcp',
+    planetscale: 'planetscale-mcp',
+    '@planetscale/mcp': 'planetscale-mcp',
+    turso: 'turso-mcp',
+    '@tursodb/mcp': 'turso-mcp',
+    mongodb: 'mongodb-mcp',
+    '@mongodb/mcp': 'mongodb-mcp',
+    // ORM MCPs
+    prisma: 'prisma-mcp',
+    '@prisma/mcp': 'prisma-mcp',
+    drizzle: 'drizzle-mcp',
+    'drizzle-orm': 'drizzle-mcp',
+    typeorm: 'typeorm-mcp',
+    // Auth MCPs
+    clerk: 'clerk-mcp',
+    '@clerk/mcp': 'clerk-mcp',
+    auth0: 'auth0-mcp',
+    '@auth0/mcp': 'auth0-mcp',
+    'supabase-auth': 'supabase-auth-mcp',
+    lucia: 'lucia-mcp',
+    // Payments MCPs
+    stripe: 'stripe-mcp',
+    '@stripe/mcp': 'stripe-mcp',
+    paddle: 'paddle-mcp',
+    '@paddle/mcp': 'paddle-mcp',
+    lemonsqueezy: 'lemonsqueezy-mcp',
+    'lemon-squeezy': 'lemonsqueezy-mcp',
+    // Deployment MCPs
+    vercel: 'vercel-mcp',
+    '@vercel/mcp': 'vercel-mcp',
+    netlify: 'netlify-mcp',
+    '@netlify/mcp': 'netlify-mcp',
+    cloudflare: 'cloudflare-mcp',
+    '@cloudflare/mcp': 'cloudflare-mcp',
+    railway: 'railway-mcp',
+    fly: 'fly-mcp',
+    'fly.io': 'fly-mcp',
+    render: 'render-mcp',
+    // Storage MCPs
+    r2: 'r2-mcp',
+    'cloudflare-r2': 'r2-mcp',
+    s3: 's3-mcp',
+    'aws-s3': 's3-mcp',
+    uploadthing: 'uploadthing-mcp',
+    // Email MCPs
+    resend: 'resend-mcp',
+    '@resend/mcp': 'resend-mcp',
+    sendgrid: 'sendgrid-mcp',
+    postmark: 'postmark-mcp',
+    // Version Control MCPs
+    github: 'github-mcp',
+    '@github/mcp': 'github-mcp',
+    gitlab: 'gitlab-mcp',
+    '@gitlab/mcp': 'gitlab-mcp',
+    // AI MCPs
+    openai: 'openai-mcp',
+    '@openai/mcp': 'openai-mcp',
+    anthropic: 'anthropic-mcp',
+    '@anthropic/mcp': 'anthropic-mcp',
+    perplexity: 'perplexity-mcp',
+    context7: 'context7-mcp',
+    // Communication MCPs
+    slack: 'slack-mcp',
+    '@slack/mcp': 'slack-mcp',
+    discord: 'discord-mcp',
+    telegram: 'telegram-mcp',
+    // Monitoring MCPs
+    sentry: 'sentry-mcp',
+    '@sentry/mcp': 'sentry-mcp',
+    datadog: 'datadog-mcp',
+    // Testing MCPs
+    playwright: 'playwright-mcp',
+    '@playwright/mcp': 'playwright-mcp',
+    puppeteer: 'puppeteer-mcp',
+    // Documentation MCPs
+    obsidian: 'obsidian-mcp',
+    notion: 'notion-mcp',
+    confluence: 'confluence-mcp',
+    // General MCPs
+    filesystem: 'filesystem-mcp',
+    'sequential-thinking': 'sequential-thinking-mcp',
+    'brave-search': 'brave-search-mcp',
+};
+/**
+ * Canonicalize an MCP ID to a consistent format.
+ *
+ * @param id - The MCP ID to canonicalize (e.g., "supabase", "@supabase/mcp")
+ * @returns The canonical ID (e.g., "supabase-mcp")
+ */
+export function canonicalizeMcpId(id) {
+    const normalized = id.toLowerCase().trim();
+    return MCP_ALIASES[normalized] ?? normalized;
+}
+/**
+ * Generate a consistent pair key for two MCPs.
+ * The key is ordered alphabetically to ensure A/B and B/A produce the same key.
+ *
+ * @param a - First MCP ID
+ * @param b - Second MCP ID
+ * @returns Pair key in format "mcpA::mcpB" (alphabetically ordered)
+ */
+export function pairKey(a, b) {
+    const canonA = canonicalizeMcpId(a);
+    const canonB = canonicalizeMcpId(b);
+    const [first, second] = [canonA, canonB].sort();
+    return `${first}::${second}`;
+}
+/**
+ * Rules indexed by pair key for O(1) lookup.
+ * Populated by initRulesIndex().
+ */
+let RULES_BY_PAIR = new Map();
+/**
+ * Initialize the rules index from an array of rules.
+ * Must be called before using findRule().
+ *
+ * @param rules - Array of compatibility rules
+ */
+export function initRulesIndex(rules) {
+    RULES_BY_PAIR = new Map();
+    for (const rule of rules) {
+        const key = pairKey(rule.mcpA, rule.mcpB);
+        RULES_BY_PAIR.set(key, rule);
+    }
+}
+/**
+ * Get the rules index (for testing).
+ */
+export function getRulesIndex() {
+    return RULES_BY_PAIR;
+}
+/**
+ * Find a compatibility rule for two MCPs.
+ * Order doesn't matter: findRule(A, B) === findRule(B, A)
+ *
+ * @param a - First MCP ID (can be any alias)
+ * @param b - Second MCP ID (can be any alias)
+ * @returns The matching rule, or undefined if no rule exists
+ */
+export function findRule(a, b) {
+    const key = pairKey(a, b);
+    return RULES_BY_PAIR.get(key);
+}
+/**
+ * Generate all unique pairs from an array of MCPs.
+ * Used to check all nC2 combinations.
+ *
+ * @param mcps - Array of MCP IDs
+ * @returns Array of [mcpA, mcpB] pairs
+ */
+export function generatePairs(mcps) {
+    const pairs = [];
+    for (let i = 0; i < mcps.length; i++) {
+        for (let j = i + 1; j < mcps.length; j++) {
+            pairs.push([mcps[i], mcps[j]]);
+        }
+    }
+    return pairs;
+}
+/**
+ * Check all pairs of MCPs for compatibility issues.
+ *
+ * @param mcps - Array of MCP IDs to check
+ * @returns Object with categorized matched rules
+ */
+export function checkAllPairs(mcps) {
+    const conflicts = [];
+    const redundancies = [];
+    const synergies = [];
+    const conditionals = [];
+    const pairs = generatePairs(mcps);
+    for (const [a, b] of pairs) {
+        const rule = findRule(a, b);
+        if (rule) {
+            const matched = {
+                rule,
+                inputA: a,
+                inputB: b,
+            };
+            switch (rule.status) {
+                case 'conflict':
+                    conflicts.push(matched);
+                    break;
+                case 'redundant':
+                    redundancies.push(matched);
+                    break;
+                case 'synergy':
+                    synergies.push(matched);
+                    break;
+                case 'conditional':
+                    conditionals.push(matched);
+                    break;
+                // 'compatible' - no action needed
+            }
+        }
+    }
+    return { conflicts, redundancies, synergies, conditionals };
+}
+/**
+ * Get suggestions based on synergy rules.
+ * If user has MCP A and rule says A+B is a synergy,
+ * suggest B if user doesn't have it.
+ *
+ * @param mcps - Array of installed MCP IDs
+ * @param allRules - All compatibility rules
+ * @returns Array of suggestions
+ */
+export function getSuggestions(mcps, allRules) {
+    const suggestions = [];
+    const canonicalMcps = new Set(mcps.map(canonicalizeMcpId));
+    const suggestedSet = new Set();
+    // Find synergy rules where user has one but not the other
+    for (const rule of allRules) {
+        if (rule.status !== 'synergy')
+            continue;
+        const hasA = canonicalMcps.has(rule.mcpA);
+        const hasB = canonicalMcps.has(rule.mcpB);
+        // If user has A but not B
+        if (hasA && !hasB && !suggestedSet.has(rule.mcpB)) {
+            suggestions.push({
+                mcp: rule.mcpB,
+                reason: rule.reason,
+                basedOn: rule.mcpA,
+            });
+            suggestedSet.add(rule.mcpB);
+        }
+        // If user has B but not A
+        if (hasB && !hasA && !suggestedSet.has(rule.mcpA)) {
+            suggestions.push({
+                mcp: rule.mcpA,
+                reason: rule.reason,
+                basedOn: rule.mcpB,
+            });
+            suggestedSet.add(rule.mcpA);
+        }
+        // Check suggestWhenMissing field
+        if (rule.suggestWhenMissing && (hasA || hasB)) {
+            for (const suggested of rule.suggestWhenMissing) {
+                const canonSuggested = canonicalizeMcpId(suggested);
+                if (!canonicalMcps.has(canonSuggested) && !suggestedSet.has(canonSuggested)) {
+                    suggestions.push({
+                        mcp: canonSuggested,
+                        reason: `Pairs well with ${hasA ? rule.mcpA : rule.mcpB}`,
+                        basedOn: hasA ? rule.mcpA : rule.mcpB,
+                    });
+                    suggestedSet.add(canonSuggested);
+                }
+            }
+        }
+    }
+    return suggestions;
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/mcp-compatibility/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/mcp-compatibility/utils.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAuSxC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiFpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAsjBxC"}