@neurynae/toolcairn-mcp 0.1.0

package/dist/templates/agent-instructions.js

@@ -0,0 +1,155 @@
+// Agent instruction templates for toolpilot_init.
+// Each function returns the section content to inject into the agent's instruction file.
+// The agent writes the content to the appropriate file — MCP server never touches the filesystem.
+const TOOLPILOT_MCP_ENTRY = {
+    toolpilot: {
+        command: 'node',
+        args: ['<path-to-toolpilot>/apps/mcp-server/dist/index.js'],
+        env: {
+            MEMGRAPH_URL: 'bolt://localhost:7687',
+            QDRANT_URL: 'http://localhost:6333',
+            DATABASE_URL: 'postgresql://toolpilot:toolpilot@localhost:5432/toolpilot',
+            REDIS_URL: 'redis://localhost:6379',
+        },
+    },
+};
+const CORE_RULES = `
+## ToolPilot — Tool Intelligence MCP
+
+ToolPilot is your tool intelligence co-pilot. It has a graph database of 500+ indexed tools with health signals, compatibility data, and known issue tracking. Always use it before recommending any tool, library, or framework.
+
+### Workflow for Tool Selection
+
+1. **Before recommending any tool**: Always call \`search_tools\` first. Never recommend from training data alone.
+2. **When user describes a use case**: Call \`classify_prompt\` first, then \`refine_requirement\` if tool selection is needed.
+3. **When starting a new project**: Call \`toolpilot_init\` to set up .toolpilot/config.json.
+4. **When resuming work on a project**: Read .toolpilot/config.json via \`read_project_config\` to see confirmed tools.
+5. **When a tool is selected**: Call \`update_project_config\` to persist the choice.
+6. **When encountering an error with a tool**: Call \`check_issue\` before debugging — it may be a known issue with an open GitHub ticket.
+7. **When user asks to compare tools**: Call \`compare_tools\` for a structured comparison with health data.
+8. **When user chooses a non-indexed/proprietary tool**: Add it to config with source: "non_oss" via \`update_project_config\`.
+
+### Available ToolPilot MCP Tools
+
+| Tool | When to use |
+|------|------------|
+| \`classify_prompt\` | User describes a task — determine if tool search needed |
+| \`refine_requirement\` | Decompose vague use case into searchable tool needs |
+| \`search_tools\` | Find the best tool for a specific need |
+| \`search_tools_respond\` | Answer clarification questions from search_tools |
+| \`get_stack\` | Get recommended tool stack for a use case |
+| \`check_issue\` | Check if an error is a known tool bug before debugging |
+| \`check_compatibility\` | Check if two tools work well together |
+| \`compare_tools\` | Compare two tools with health and graph data |
+| \`report_outcome\` | Report whether a recommended tool worked (improves future results) |
+| \`toolpilot_init\` | Set up ToolPilot for a new project |
+| \`init_project_config\` | Initialize .toolpilot/config.json |
+| \`read_project_config\` | Parse .toolpilot/config.json to get confirmed tools |
+| \`update_project_config\` | Add/remove/update tools in .toolpilot/config.json |
+| \`suggest_graph_update\` | Suggest a new tool or relationship for the ToolPilot graph |
+
+### Rules
+
+- NEVER recommend a tool without first checking ToolPilot unless the tool is already in .toolpilot/config.json
+- Always check .toolpilot/config.json at the start of a session if it exists
+- Prefer open-source tools from ToolPilot index; flag proprietary alternatives clearly
+- After selecting a tool, always call \`update_project_config\` to persist it
+- After using a tool successfully/unsuccessfully, call \`report_outcome\`
+`;
+export function getClaudeInstructions() {
+    return {
+        file_path: 'CLAUDE.md',
+        mode: 'append',
+        content: CORE_RULES,
+    };
+}
+export function getCursorInstructions() {
+    return {
+        file_path: '.cursorrules',
+        mode: 'append',
+        content: CORE_RULES,
+    };
+}
+export function getWindsurfInstructions() {
+    return {
+        file_path: '.windsurfrules',
+        mode: 'append',
+        content: CORE_RULES,
+    };
+}
+export function getCopilotInstructions() {
+    return {
+        file_path: '.github/copilot-instructions.md',
+        mode: 'create',
+        content: `# GitHub Copilot Instructions\n${CORE_RULES}`,
+    };
+}
+export function getCopilotCliInstructions() {
+    // GitHub Copilot CLI reads .github/copilot-instructions.md and AGENTS.md
+    return {
+        file_path: '.github/copilot-instructions.md',
+        mode: 'append',
+        content: CORE_RULES,
+    };
+}
+export function getOpenCodeInstructions() {
+    // OpenCode reads AGENTS.md (falls back to CLAUDE.md if absent)
+    return {
+        file_path: 'AGENTS.md',
+        mode: 'append',
+        content: CORE_RULES,
+    };
+}
+export function getGenericInstructions() {
+    return {
+        file_path: 'AI_INSTRUCTIONS.md',
+        mode: 'create',
+        content: `# AI Assistant Instructions\n${CORE_RULES}`,
+    };
+}
+export function getInstructionsForAgent(agent) {
+    switch (agent) {
+        case 'claude':
+            return getClaudeInstructions();
+        case 'cursor':
+            return getCursorInstructions();
+        case 'windsurf':
+            return getWindsurfInstructions();
+        case 'copilot':
+            return getCopilotInstructions();
+        case 'copilot-cli':
+            return getCopilotCliInstructions();
+        case 'opencode':
+            return getOpenCodeInstructions();
+        case 'generic':
+            return getGenericInstructions();
+    }
+}
+export function getMcpConfigEntry(serverPath) {
+    const entry = { ...TOOLPILOT_MCP_ENTRY };
+    if (serverPath) {
+        entry.toolpilot = {
+            ...entry.toolpilot,
+            args: [serverPath],
+        };
+    }
+    return entry;
+}
+/** Returns OpenCode-specific MCP config (opencode.json format under "mcp" key). */
+export function getOpenCodeMcpEntry(serverPath) {
+    const resolvedPath = serverPath ?? '<path-to-toolpilot>/apps/mcp-server/dist/index.js';
+    return {
+        toolpilot: {
+            type: 'local',
+            command: ['node', resolvedPath],
+            env: {
+                MEMGRAPH_URL: 'bolt://localhost:7687',
+                QDRANT_URL: 'http://localhost:6333',
+                DATABASE_URL: 'postgresql://toolpilot:toolpilot@localhost:5432/toolpilot',
+                REDIS_URL: 'redis://localhost:6379',
+            },
+            enabled: true,
+        },
+    };
+}
+//# sourceMappingURL=agent-instructions.js.map

package/dist/templates/agent-instructions.js.map

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

package/dist/tools/check-compatibility.d.ts

@@ -0,0 +1,100 @@
+export declare function handleCheckCompatibility(args: {
+    tool_a: string;
+    tool_b: 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=check-compatibility.d.ts.map

package/dist/tools/check-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-compatibility.d.ts","sourceRoot":"","sources":["../../src/tools/check-compatibility.ts"],"names":[],"mappings":"AAaA,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8GtF"}

package/dist/tools/check-compatibility.js

@@ -0,0 +1,103 @@
+import { MemgraphToolRepository } from '@toolpilot/graph';
+import pino from 'pino';
+import { errResult, okResult } from '../utils.js';
+const logger = pino({ name: '@toolpilot/mcp-server:check-compatibility' });
+const repo = new MemgraphToolRepository();
+const COMPATIBLE_TYPES = new Set(['COMPATIBLE_WITH', 'INTEGRATES_WITH', 'POPULAR_WITH']);
+const CONFLICT_TYPES = new Set(['CONFLICTS_WITH', 'BREAKS_FROM']);
+const REQUIRES_TYPES = new Set(['REQUIRES']);
+export async function handleCheckCompatibility(args) {
+    try {
+        logger.info({ tool_a: args.tool_a, tool_b: args.tool_b }, 'check_compatibility called');
+        // Verify both tools exist
+        const [existsA, existsB] = await Promise.all([
+            repo.toolExists(args.tool_a),
+            repo.toolExists(args.tool_b),
+        ]);
+        if (!existsA.ok || !existsA.data) {
+            return errResult('tool_not_found', `Tool "${args.tool_a}" not found in the ToolPilot index`);
+        }
+        if (!existsB.ok || !existsB.data) {
+            return errResult('tool_not_found', `Tool "${args.tool_b}" not found in the ToolPilot index`);
+        }
+        // Check direct edges between the two tools
+        const edgesResult = await repo.getDirectEdges(args.tool_a, args.tool_b);
+        if (!edgesResult.ok) {
+            return errResult('graph_error', edgesResult.error.message);
+        }
+        const edges = edgesResult.data;
+        let status = 'unknown';
+        let confidence = 0.5;
+        const signals = [];
+        if (edges.length > 0) {
+            // Direct edges — high confidence
+            confidence = Math.max(...edges.map((e) => e.confidence));
+            if (edges.some((e) => CONFLICT_TYPES.has(e.edgeType))) {
+                status = 'conflicts';
+                signals.push(`Direct ${edges.find((e) => CONFLICT_TYPES.has(e.edgeType))?.edgeType} edge found`);
+            }
+            else if (edges.some((e) => COMPATIBLE_TYPES.has(e.edgeType))) {
+                status = 'compatible';
+                signals.push(`Direct ${edges.find((e) => COMPATIBLE_TYPES.has(e.edgeType))?.edgeType} edge found`);
+            }
+            else if (edges.some((e) => REQUIRES_TYPES.has(e.edgeType))) {
+                status = 'requires';
+                signals.push('Direct REQUIRES relationship found');
+            }
+        }
+        else {
+            // No direct edges — check 2-hop paths via shared neighbors
+            const [neighborsA, neighborsB] = await Promise.all([
+                repo.getRelated(args.tool_a, 10),
+                repo.getRelated(args.tool_b, 10),
+            ]);
+            if (neighborsA.ok && neighborsB.ok) {
+                const namesA = new Set(neighborsA.data.map((t) => t.name));
+                const namesB = new Set(neighborsB.data.map((t) => t.name));
+                const sharedNeighbors = [...namesA].filter((n) => namesB.has(n));
+                if (sharedNeighbors.length >= 3) {
+                    status = 'compatible';
+                    confidence = 0.6;
+                    signals.push(`${sharedNeighbors.length} shared graph neighbors suggest these tools are used together`);
+                }
+                else if (sharedNeighbors.length > 0) {
+                    status = 'unknown';
+                    confidence = 0.4;
+                    signals.push(`${sharedNeighbors.length} shared neighbors found — insufficient for strong inference`);
+                }
+                else {
+                    signals.push('No direct edges or shared neighbors — these tools may operate in different domains');
+                }
+            }
+        }
+        const recommendation = status === 'compatible'
+            ? `${args.tool_a} and ${args.tool_b} can be used together.`
+            : status === 'conflicts'
+                ? `${args.tool_a} and ${args.tool_b} have known conflicts. Avoid using them in the same project.`
+                : status === 'requires'
+                    ? 'One of these tools requires the other. Check the direction of the REQUIRES edge.'
+                    : 'No direct compatibility data. These tools may work together but it has not been verified.';
+        return okResult({
+            tool_a: args.tool_a,
+            tool_b: args.tool_b,
+            status,
+            confidence: Math.round(confidence * 100) / 100,
+            direct_edges: edges.map((e) => ({
+                type: e.edgeType,
+                direction: e.direction,
+                confidence: Math.round(e.confidence * 100) / 100,
+                effective_weight: Math.round(e.effective_weight * 100) / 100,
+            })),
+            signals,
+            recommendation,
+            suggest_graph_update: status === 'unknown'
+                ? `If you discover compatibility data, call suggest_graph_update with suggestion_type: "new_edge" to contribute it back.`
+                : null,
+        });
+    }
+    catch (e) {
+        logger.error({ err: e }, 'check_compatibility failed');
+        return errResult('compatibility_error', e instanceof Error ? e.message : String(e));
+    }
+}
+//# sourceMappingURL=check-compatibility.js.map

package/dist/tools/check-compatibility.js.map

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

package/dist/tools/check-issue.d.ts

@@ -0,0 +1,126 @@
+/**
+ * check_issue — Checks GitHub directly for known issues matching an error.
+ *
+ * IMPORTANT: This is a last-resort tool. The agent should:
+ *   1. Try to fix the error itself (2 retries)
+ *   2. Consult the tool's documentation (2 more retries)
+ *   3. ONLY THEN call check_issue (pass retry_count≥4, docs_consulted=true)
+ *
+ * This prevents spamming the GitHub API for errors that are config issues,
+ * environment problems, or things the docs would explain.
+ *
+ * Flow:
+ *   1. Gate: enforce retry + docs requirements
+ *   2. Look up tool's github_url in Memgraph
+ *   3. Search GitHub Issues API directly (no local DB — live data)
+ *   4. Also search for PRs that may fix the issue
+ *   5. Return one of four statuses:
+ *      - not_found:           no matching issue on GitHub → agent handles it
+ *      - fix_in_progress:     open issue + open PR exists → track PR
+ *      - known_issue_no_fix:  open issue, no PR → gist + ask user intent
+ *      - fixed_in_version:    closed issue → which version fixed it
+ *   6. In real-issue cases (3/4): add 👍 reaction to the issue via GitHub API
+ */
+export declare function handleCheckIssue(args: {
+    tool_name: string;
+    issue_title: string;
+    retry_count?: number;
+    docs_consulted?: boolean;
+    issue_url?: 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=check-issue.d.ts.map

package/dist/tools/check-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-issue.d.ts","sourceRoot":"","sources":["../../src/tools/check-issue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA8GH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KA"}