@hubium/hubium-mcp 0.1.0

package/dist/install/cursorInstaller.d.ts

@@ -0,0 +1,15 @@
+export type CursorInstallResult = {
+    ok: true;
+    path: string;
+    backupPath: string;
+    changed: boolean;
+} | {
+    ok: false;
+    reason: 'not_found' | 'invalid_json';
+    message: string;
+};
+export declare function getCursorConfigPaths(): string[];
+export declare function buildCursorConfigSnippet(): Record<string, unknown>;
+export declare function getCursorConfigSnippetJson(): string;
+export declare function installCursorConfig(): Promise<CursorInstallResult>;
+//# sourceMappingURL=cursorInstaller.d.ts.map

package/dist/install/cursorInstaller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorInstaller.d.ts","sourceRoot":"","sources":["../../src/install/cursorInstaller.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAChE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAgB/C;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYlE;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAgCxE"}

package/dist/install/cursorInstaller.js

@@ -0,0 +1,110 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+export function getCursorConfigPaths() {
+    const override = process.env.HUBIUM_CURSOR_CONFIG_DIR;
+    if (override && override.trim().length > 0) {
+        return [path.join(override, 'settings.json')];
+    }
+    const home = os.homedir();
+    const appData = process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+    const candidates = [
+        path.join(home, 'Library', 'Application Support', 'Cursor', 'User', 'settings.json'),
+        path.join(home, 'Library', 'Application Support', 'Cursor', 'settings.json'),
+        path.join(appData, 'Cursor', 'User', 'settings.json'),
+        path.join(appData, 'Cursor', 'settings.json'),
+        path.join(home, '.config', 'Cursor', 'User', 'settings.json'),
+        path.join(home, '.config', 'Cursor', 'settings.json'),
+    ];
+    return candidates;
+}
+export function buildCursorConfigSnippet() {
+    return {
+        mcpServers: {
+            hubium: {
+                command: 'npx',
+                args: ['-y', 'hubium-mcp@^1', 'serve'],
+                env: {
+                    HUBIUM_BASE_URL: 'https://hubium.dev',
+                },
+            },
+        },
+    };
+}
+export function getCursorConfigSnippetJson() {
+    return JSON.stringify(buildCursorConfigSnippet(), null, 2);
+}
+export async function installCursorConfig() {
+    const pathFound = await findExistingConfigPath();
+    if (!pathFound) {
+        return {
+            ok: false,
+            reason: 'not_found',
+            message: 'Cursor settings.json not found. Add the snippet manually.',
+        };
+    }
+    const raw = await fs.readFile(pathFound, 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {
+            ok: false,
+            reason: 'invalid_json',
+            message: 'Cursor settings.json is not valid JSON. Fix it before installing.',
+        };
+    }
+    const updated = applyCursorConfig(parsed);
+    const changed = JSON.stringify(parsed) !== JSON.stringify(updated);
+    const backupPath = `${pathFound}.bak`;
+    if (!(await exists(backupPath))) {
+        await fs.writeFile(backupPath, raw, 'utf8');
+    }
+    if (changed) {
+        await fs.writeFile(pathFound, JSON.stringify(updated, null, 2) + '\n', 'utf8');
+    }
+    return { ok: true, path: pathFound, backupPath, changed };
+}
+function applyCursorConfig(input) {
+    const output = { ...input };
+    const mcpServers = (output.mcpServers && typeof output.mcpServers === 'object')
+        ? { ...output.mcpServers }
+        : {};
+    const existing = (mcpServers.hubium && typeof mcpServers.hubium === 'object')
+        ? mcpServers.hubium
+        : {};
+    const env = (existing.env && typeof existing.env === 'object')
+        ? { ...existing.env }
+        : {};
+    if (!('HUBIUM_BASE_URL' in env)) {
+        env.HUBIUM_BASE_URL = 'https://hubium.dev';
+    }
+    mcpServers.hubium = {
+        ...existing,
+        command: 'npx',
+        args: ['-y', 'hubium-mcp@^1', 'serve'],
+        env,
+    };
+    output.mcpServers = mcpServers;
+    return output;
+}
+async function findExistingConfigPath() {
+    const candidates = getCursorConfigPaths();
+    for (const candidate of candidates) {
+        if (await exists(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=cursorInstaller.js.map

package/dist/install/cursorInstaller.js.map

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

package/dist/install/cursorInstaller.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cursorInstaller.test.d.ts.map

package/dist/install/cursorInstaller.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorInstaller.test.d.ts","sourceRoot":"","sources":["../../src/install/cursorInstaller.test.ts"],"names":[],"mappings":""}

package/dist/install/cursorInstaller.test.js

@@ -0,0 +1,120 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { buildCursorConfigSnippet, getCursorConfigSnippetJson, getCursorConfigPaths, installCursorConfig, } from './cursorInstaller.js';
+const originalEnv = { ...process.env };
+let tempDir = '';
+beforeEach(async () => {
+    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'hubium-mcp-install-'));
+    process.env = {
+        ...originalEnv,
+        HOME: tempDir,
+        APPDATA: path.join(tempDir, 'AppData', 'Roaming'),
+        HUBIUM_CURSOR_CONFIG_DIR: tempDir,
+    };
+});
+afterEach(async () => {
+    process.env = { ...originalEnv };
+    if (tempDir) {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+    vi.restoreAllMocks();
+});
+function cursorSettingsPath() {
+    return path.join(tempDir, 'settings.json');
+}
+describe('cursorInstaller', () => {
+    it('print-config output is valid JSON and includes major pin', () => {
+        const json = getCursorConfigSnippetJson();
+        const parsed = JSON.parse(json);
+        const snippet = buildCursorConfigSnippet();
+        expect(parsed).toEqual(snippet);
+        expect(json).toContain('hubium-mcp@^1');
+        expect(json).toContain('"serve"');
+    });
+    it('print-config output does not contain raw tokens', () => {
+        const json = getCursorConfigSnippetJson();
+        expect(json).not.toMatch(/Bearer\s+[A-Za-z0-9_.-]+/);
+        expect(json).not.toMatch(/hb_[A-Za-z0-9_-]+/);
+        expect(json).not.toContain('HUBIUM_TOKEN');
+    });
+    it('install writes config and creates backup', async () => {
+        const settingsPath = cursorSettingsPath();
+        await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs.writeFile(settingsPath, JSON.stringify({ foo: 'bar' }), 'utf8');
+        const result = await installCursorConfig();
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            const updated = JSON.parse(await fs.readFile(settingsPath, 'utf8'));
+            expect(updated.mcpServers).toBeDefined();
+            expect(await fs.readFile(`${settingsPath}.bak`, 'utf8')).toContain('"foo":"bar"');
+        }
+    });
+    it('install is idempotent and does not create multiple backups', async () => {
+        const settingsPath = cursorSettingsPath();
+        await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs.writeFile(settingsPath, JSON.stringify({ mcpServers: {} }), 'utf8');
+        const first = await installCursorConfig();
+        const firstContents = await fs.readFile(settingsPath, 'utf8');
+        const second = await installCursorConfig();
+        const secondContents = await fs.readFile(settingsPath, 'utf8');
+        expect(first.ok).toBe(true);
+        expect(second.ok).toBe(true);
+        const backup = await fs.readFile(`${settingsPath}.bak`, 'utf8');
+        expect(backup).toContain('mcpServers');
+        expect(secondContents).toBe(firstContents);
+    });
+    it('install never writes token from env', async () => {
+        process.env.HUBIUM_TOKEN = 'SECRET';
+        const settingsPath = cursorSettingsPath();
+        await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs.writeFile(settingsPath, JSON.stringify({}), 'utf8');
+        const result = await installCursorConfig();
+        expect(result.ok).toBe(true);
+        const updated = await fs.readFile(settingsPath, 'utf8');
+        expect(updated).not.toContain('SECRET');
+        expect(updated).not.toContain('HUBIUM_TOKEN');
+    });
+    it('install preserves existing servers and settings', async () => {
+        const settingsPath = cursorSettingsPath();
+        await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs.writeFile(settingsPath, JSON.stringify({
+            mcpServers: { other: { command: 'node' } },
+            editor: { fontSize: 12 },
+        }), 'utf8');
+        const result = await installCursorConfig();
+        expect(result.ok).toBe(true);
+        const updated = JSON.parse(await fs.readFile(settingsPath, 'utf8'));
+        expect(updated.mcpServers.other).toBeDefined();
+        expect(updated.editor).toEqual({ fontSize: 12 });
+    });
+    it('uses most likely Cursor path', () => {
+        const original = process.env.HUBIUM_CURSOR_CONFIG_DIR;
+        delete process.env.HUBIUM_CURSOR_CONFIG_DIR;
+        const paths = getCursorConfigPaths();
+        process.env.HUBIUM_CURSOR_CONFIG_DIR = original;
+        expect(paths[0]).toContain(path.join('Cursor', 'User', 'settings.json'));
+    });
+    it('returns not_found when config missing', async () => {
+        const result = await installCursorConfig();
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.reason).toBe('not_found');
+        }
+    });
+    it('returns invalid_json and does not write backup', async () => {
+        const settingsPath = cursorSettingsPath();
+        await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs.writeFile(settingsPath, '{not json', 'utf8');
+        const result = await installCursorConfig();
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.reason).toBe('invalid_json');
+        }
+        await expect(fs.readFile(`${settingsPath}.bak`, 'utf8')).rejects.toThrow();
+        const raw = await fs.readFile(settingsPath, 'utf8');
+        expect(raw).toBe('{not json');
+    });
+});
+//# sourceMappingURL=cursorInstaller.test.js.map

package/dist/install/cursorInstaller.test.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,72 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { type CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import { ContextManager } from './context/contextManager.js';
+import { TokenStore } from './token/tokenStore.js';
+import type { HubiumCreateCaseRequest, HubiumCreateCaseResponse, HubiumFeedbackRequest, HubiumFeedbackResponse, HubiumGetCaseResponse, HubiumSearchResponse, HubiumWhoamiResponse } from '@hubium/client';
+export type RateLimitResult = {
+    ok: true;
+} | {
+    ok: false;
+    retryAfterMs: number;
+};
+export type RateLimiter = {
+    allow: () => RateLimitResult;
+};
+export type ToolDeps = {
+    contextManager: ContextManager;
+    tokenStore: Pick<TokenStore, 'getToken' | 'getFollowupToken' | 'setFollowupToken' | 'clearFollowupToken'>;
+    fetchImpl?: typeof fetch;
+    hubiumClientFactory: (input: {
+        baseUrl: string;
+        token?: string;
+    }) => {
+        whoami: () => Promise<HubiumWhoamiResponse>;
+        search: (params: {
+            query?: string;
+            q?: string;
+            limit?: number;
+            offset?: number;
+            workspace_id?: string;
+            workspace_ids?: string[];
+        }, options?: {
+            followupToken?: string;
+        }) => Promise<HubiumSearchResponse>;
+        getCase: (caseId: string, options?: {
+            workspace_id?: string;
+            workspace_ids?: string[];
+        }) => Promise<HubiumGetCaseResponse>;
+        createCase: (payload: HubiumCreateCaseRequest, options?: {
+            idempotencyKey?: string;
+        }) => Promise<HubiumCreateCaseResponse>;
+        addFeedback: (caseId: string, payload: HubiumFeedbackRequest, options?: {
+            idempotencyKey?: string;
+        }) => Promise<HubiumFeedbackResponse>;
+    };
+    safeMode: boolean;
+    rateLimiter: RateLimiter;
+};
+export declare function createServer(deps?: Partial<ToolDeps>): Server;
+export declare function runServerStdio(options?: {
+    safeMode?: boolean;
+}): Promise<void>;
+export declare function registerTools(server: Server, deps: ToolDeps): void;
+export declare function buildToolHandlers(deps: ToolDeps): {
+    listTools: () => Promise<{
+        tools: Array<Record<string, unknown>>;
+    }>;
+    callTool: (request: CallToolRequest) => Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+};
+export declare function createRateLimiterFromEnv(): RateLimiter;
+export declare class LocalRateLimiter implements RateLimiter {
+    private readonly limit;
+    private readonly windowMs;
+    private readonly timestamps;
+    constructor(limit: number, windowMs: number);
+    allow(): RateLimitResult;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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