@neurynae/toolcairn-mcp 0.1.0

package/dist/tools/verify-suggestion.d.ts

@@ -0,0 +1,113 @@
+/**
+ * verify_suggestion — Validates agent-suggested tools against the ToolPilot graph.
+ *
+ * Called when search_tools returns no results or low-confidence results and the
+ * calling agent (Claude, Cursor, etc.) has suggestions from its training data.
+ *
+ * For each suggestion:
+ * 1. FOUND in graph → diagnose why search missed it (category mismatch, low health,
+ *    Stage 2 filter, not in Qdrant yet) and return corrected data from our index.
+ * 2. NOT in graph → enqueue at P0 (highest priority), search GitHub for alternatives
+ *    matching the query, compare agent's suggestion vs what GitHub returns, and return
+ *    a verdict on which is correct with reasoning.
+ */
+export declare function handleVerifySuggestion(args: {
+    query: string;
+    agent_suggestions: string[];
+}): Promise<{
+    [x: string]: unknown;
+    content: ({
+        type: "text";
+        text: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        type: "audio";
+        data: string;
+        mimeType: string;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        uri: string;
+        name: string;
+        type: "resource_link";
+        description?: string | undefined;
+        mimeType?: string | undefined;
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        icons?: {
+            src: string;
+            mimeType?: string | undefined;
+            sizes?: string[] | undefined;
+            theme?: "light" | "dark" | undefined;
+        }[] | undefined;
+        title?: string | undefined;
+    } | {
+        type: "resource";
+        resource: {
+            uri: string;
+            text: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            uri: string;
+            blob: string;
+            mimeType?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        };
+        annotations?: {
+            audience?: ("user" | "assistant")[] | undefined;
+            priority?: number | undefined;
+            lastModified?: string | undefined;
+        } | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+    structuredContent?: {
+        [x: string]: unknown;
+    } | undefined;
+    isError?: boolean | undefined;
+}>;
+//# sourceMappingURL=verify-suggestion.d.ts.map

package/dist/tools/verify-suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-suggestion.d.ts","sourceRoot":"","sources":["../../src/tools/verify-suggestion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA0KH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+GA"}

package/dist/tools/verify-suggestion.js

@@ -0,0 +1,223 @@
+/**
+ * verify_suggestion — Validates agent-suggested tools against the ToolPilot graph.
+ *
+ * Called when search_tools returns no results or low-confidence results and the
+ * calling agent (Claude, Cursor, etc.) has suggestions from its training data.
+ *
+ * For each suggestion:
+ * 1. FOUND in graph → diagnose why search missed it (category mismatch, low health,
+ *    Stage 2 filter, not in Qdrant yet) and return corrected data from our index.
+ * 2. NOT in graph → enqueue at P0 (highest priority), search GitHub for alternatives
+ *    matching the query, compare agent's suggestion vs what GitHub returns, and return
+ *    a verdict on which is correct with reasoning.
+ */
+import { MemgraphToolRepository, MemgraphUseCaseRepository } from '@toolpilot/graph';
+import { enqueueIndexJob } from '@toolpilot/queue';
+import { COLLECTION_NAME, embedText, qdrantClient } from '@toolpilot/vector';
+import pino from 'pino';
+import { errResult, okResult } from '../utils.js';
+import { config } from '@toolpilot/config';
+const logger = pino({ name: '@toolpilot/mcp-server:verify-suggestion' });
+const toolRepo = new MemgraphToolRepository();
+const usecaseRepo = new MemgraphUseCaseRepository();
+// Priority 2 = highest urgency in the indexer queue (compare: 0=background, 1=normal, 2=urgent)
+const P0_PRIORITY = 2;
+/**
+ * Resolve a bare tool name (e.g. "yjs") to a full GitHub URL.
+ * Uses GitHub Search API (via fetch) to find the most-starred repo matching the name.
+ * If name already contains "/" or "github.com", returns it as-is.
+ */
+async function resolveToGitHubUrl(nameOrUrl) {
+    // Already a full URL or owner/repo format — indexer handles these directly
+    if (nameOrUrl.includes('github.com') || nameOrUrl.includes('/')) {
+        return nameOrUrl;
+    }
+    // Bare name — search GitHub Search API for the most-starred match
+    try {
+        const token = config.GITHUB_TOKEN;
+        const headers = { Accept: 'application/vnd.github+json' };
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        const res = await fetch(`https://api.github.com/search/repositories?q=${encodeURIComponent(nameOrUrl)}+in:name&sort=stars&order=desc&per_page=1`, { headers });
+        if (res.ok) {
+            const data = (await res.json());
+            const url = data.items?.[0]?.html_url;
+            if (url)
+                return url;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return nameOrUrl; // let the indexer try its best
+}
+/**
+ * Check if a tool is present in Qdrant with a non-zero vector.
+ * If missing from Qdrant, that's likely why search missed it.
+ */
+async function checkQdrantPresence(toolName) {
+    try {
+        const { points } = await qdrantClient().scroll(COLLECTION_NAME, {
+            filter: { must: [{ key: 'name', match: { value: toolName } }] },
+            limit: 1,
+            with_payload: true,
+            with_vector: false,
+        });
+        const p = points[0];
+        if (!p?.payload)
+            return { present: false, hasVector: false, hasTopics: false };
+        return {
+            present: true,
+            hasVector: true, // we can't check vector without fetching it, assume present if payload exists
+            hasTopics: Array.isArray(p.payload.topics) && p.payload.topics.length > 0,
+        };
+    }
+    catch {
+        return { present: false, hasVector: false, hasTopics: false };
+    }
+}
+/**
+ * Diagnose why a tool that IS in the graph didn't appear in search results.
+ */
+async function diagnoseSearchMiss(tool) {
+    const reasons = [];
+    // 1. Not in Qdrant → Stage 1 vector search can't find it
+    const qdrantStatus = await checkQdrantPresence(tool.name);
+    if (!qdrantStatus.present) {
+        reasons.push('not present in Qdrant vector store — tool exists in Memgraph but was never embedded');
+    }
+    else if (!qdrantStatus.hasTopics) {
+        reasons.push('in Qdrant but topics field is empty — embedding may use stale schema without topic-aware text, reducing semantic match quality');
+    }
+    // 2. Health score too low → Stage 4 might filter it
+    if (tool.health.maintenance_score < 0.3) {
+        reasons.push(`very low health score (${Math.round(tool.health.maintenance_score * 100)}%) — may be deprioritized in Stage 3 graph reranking`);
+    }
+    // 3. Category is "other" → clarification filter might exclude it
+    if (tool.category === 'other') {
+        reasons.push('category is "other" — tool has no specific category, so topic-based clarification filters won\'t surface it unless the user skips topic selection');
+    }
+    // 4. Category mismatch → wrong UseCase nodes
+    const usecases = await usecaseRepo.findToolsByUseCases([tool.category], 5);
+    if (!usecases.ok || usecases.data.length === 0) {
+        reasons.push(`category "${tool.category}" has no matching UseCase node — tool won't be found via graph traversal in get_stack or Stage 3`);
+    }
+    return reasons.length > 0
+        ? reasons.join('; ')
+        : 'unclear — tool appears correctly indexed. May have been filtered by Stage 2 language/license constraints or ranked below threshold in Stage 4.';
+}
+/**
+ * Use semantic search to find the closest tools to the query in the current index.
+ * Returns top matches as "what ToolPilot would recommend" for comparison.
+ */
+async function semanticSearch(query, limit = 3) {
+    try {
+        const vec = await embedText(query, 'search_query');
+        const results = await qdrantClient().search(COLLECTION_NAME, {
+            vector: vec,
+            limit,
+            with_payload: true,
+        });
+        return results
+            .filter((r) => r.payload)
+            .map((r) => ({
+            name: String(r.payload?.name ?? ''),
+            score: Math.round(r.score * 100) / 100,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Handler ─────────────────────────────────────────────────────────────────
+export async function handleVerifySuggestion(args) {
+    try {
+        logger.info({ query: args.query, suggestions: args.agent_suggestions }, 'verify_suggestion called');
+        const results = [];
+        const toIndex = [];
+        // ── Phase 1: check each suggestion against the graph ─────────────────────
+        for (const toolName of args.agent_suggestions) {
+            const found = await toolRepo.findByName(toolName);
+            if (found.ok && found.data) {
+                const tool = found.data;
+                const qdrantStatus = await checkQdrantPresence(toolName);
+                // Tool is in graph — check if search should have returned it
+                const missReason = qdrantStatus.present
+                    ? await diagnoseSearchMiss(tool)
+                    : 'not present in Qdrant — tool was in Memgraph but never embedded into the vector store';
+                const isCorrectlyIndexed = qdrantStatus.present && qdrantStatus.hasTopics && tool.category !== 'other';
+                results.push({
+                    tool_name: toolName,
+                    status: isCorrectlyIndexed ? 'found_and_correct' : 'found_search_missed',
+                    in_graph: true,
+                    tool_data: {
+                        description: tool.description,
+                        github_url: tool.github_url,
+                        stars: tool.health.stars,
+                        maintenance_score: Math.round(tool.health.maintenance_score * 100) / 100,
+                        last_commit: tool.health.last_commit_date,
+                        category: tool.category,
+                        topics: tool.topics ?? [],
+                    },
+                    qdrant_present: qdrantStatus.present,
+                    search_miss_reason: isCorrectlyIndexed ? undefined : missReason,
+                    verdict: isCorrectlyIndexed
+                        ? `"${toolName}" is correctly indexed. Agent suggestion matches ToolPilot data. Use this tool.`
+                        : `"${toolName}" is in the graph but search missed it: ${missReason}. Agent suggestion is valid — triggering re-embed.`,
+                });
+                // If not properly in Qdrant, re-index at P0 to fix it
+                if (!qdrantStatus.present || !qdrantStatus.hasTopics) {
+                    toIndex.push(tool.github_url);
+                }
+            }
+            else {
+                // Not in graph at all — resolve name to GitHub URL, then queue at P0
+                const githubUrl = await resolveToGitHubUrl(toolName);
+                toIndex.push(githubUrl);
+                results.push({
+                    tool_name: toolName,
+                    status: 'not_indexed_queued',
+                    in_graph: false,
+                    indexing_eta_seconds: 120,
+                    verdict: `"${toolName}" is not in the ToolPilot index. Resolved to ${githubUrl !== toolName ? githubUrl : 'GitHub'} and indexing triggered at P0 priority (~2 min). Call verify_suggestion again after indexing completes.`,
+                });
+            }
+        }
+        // ── Phase 2: enqueue missing/broken tools at P0 ───────────────────────────
+        const enqueueResults = await Promise.allSettled(toIndex.map((id) => enqueueIndexJob(id, P0_PRIORITY)));
+        const enqueued = enqueueResults.filter((r) => r.status === 'fulfilled').length;
+        // ── Phase 3: semantic comparison — what ToolPilot would recommend ─────────
+        const ourRecommendations = await semanticSearch(args.query, 3);
+        const foundInGraph = results.filter((r) => r.in_graph).map((r) => r.tool_name);
+        const notInGraph = results.filter((r) => !r.in_graph).map((r) => r.tool_name);
+        // Cross-reference: are our semantic recommendations different from agent suggestions?
+        const agentSet = new Set(args.agent_suggestions.map((s) => s.toLowerCase()));
+        const _ourSet = new Set(ourRecommendations.map((r) => r.name.toLowerCase()));
+        const agreement = ourRecommendations.filter((r) => agentSet.has(r.name.toLowerCase()));
+        const disagreement = ourRecommendations.filter((r) => !agentSet.has(r.name.toLowerCase()));
+        logger.info({ enqueued, foundInGraph: foundInGraph.length, notInGraph: notInGraph.length }, 'verify_suggestion complete');
+        return okResult({
+            suggestions: results,
+            enqueued_for_indexing: toIndex,
+            indexing_priority: 'P0 (urgent)',
+            our_semantic_recommendations: ourRecommendations,
+            agreement_analysis: {
+                agreed_tools: agreement.map((r) => r.name),
+                our_alternatives: disagreement.map((r) => r.name),
+                verdict: agreement.length > 0
+                    ? `ToolPilot agrees with agent on: ${agreement.map((r) => r.name).join(', ')}. Both signal high confidence.`
+                    : disagreement.length > 0
+                        ? `ToolPilot recommends different tools: ${disagreement.map((r) => r.name).join(', ')}. Agent suggestions may be from older training data or niche tools not yet indexed.`
+                        : 'Unable to compare — index query returned no results. Agent suggestions are the best available signal.',
+            },
+            next_steps: toIndex.length > 0
+                ? `${toIndex.length} tool(s) queued for indexing at P0. Call verify_suggestion again in ~2 minutes for full comparison.`
+                : 'All tools verified. Use the verdict fields above to guide tool selection.',
+        });
+    }
+    catch (e) {
+        logger.error({ err: e }, 'verify_suggestion failed');
+        return errResult('verify_error', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=verify-suggestion.js.map

package/dist/tools/verify-suggestion.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,5 @@
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { config } from '@toolpilot/config';
+export declare function createTransport(): Transport;
+export { config };
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,wBAAgB,eAAe,IAAI,SAAS,CAO3C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/transport.js

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { config } from '@toolpilot/config';
+export function createTransport() {
+    if (process.env.MCP_TRANSPORT === 'http') {
+        return new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => crypto.randomUUID(),
+        });
+    }
+    return new StdioServerTransport();
+}
+export { config };
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,IAAI,6BAA6B,CAAC;YACvC,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;SAC9C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,oBAAoB,EAAE,CAAC;AACpC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function okResult(data: unknown): CallToolResult;
+export declare function errResult(error: string, message: string): CallToolResult;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAItD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAKxE"}

package/dist/utils.js

@@ -0,0 +1,12 @@
+export function okResult(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ ok: true, data }) }],
+    };
+}
+export function errResult(error, message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ ok: false, error, message }) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,OAAe;IACtD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAChF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@neurynae/toolcairn-mcp",
+  "version": "0.1.0",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "description": "ToolCairn MCP — graph-powered tool intelligence for AI agents",
+  "homepage": "https://neurynae.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NEURYNAE/ToolCairn"
+  },
+  "keywords": ["mcp", "ai", "tools", "graph", "developer-tools", "toolcairn", "neurynae", "tool-intelligence"],
+  "bin": {
+    "toolcairn-mcp": "./bin/toolpilot-mcp.js"
+  },
+  "files": ["dist/", "bin/", "data/"],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "build:publish": "tsup",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test:unit": "vitest run",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.7.0",
+    "pino": "^9.6.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@toolpilot/config": "workspace:*",
+    "@toolpilot/core": "workspace:*",
+    "@toolpilot/db": "workspace:*",
+    "@toolpilot/graph": "workspace:*",
+    "@toolpilot/queue": "workspace:*",
+    "@toolpilot/remote": "workspace:*",
+    "@toolpilot/search": "workspace:*",
+    "@toolpilot/tools": "workspace:*",
+    "@toolpilot/tsconfig": "workspace:*",
+    "@toolpilot/vector": "workspace:*",
+    "@types/node": "^22.10.7",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.4"
+  }
+}