@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.0

package/dist/plugin/registry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Registry — turns a list of plugins into the server's tool list, permission groups and call routing.
+ *
+ * Everything that used to be edited by hand per tool (import, list entry, switch case, permission group,
+ * credential check, boot summary) is derived here from the plugin definitions.
+ */
+import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
+import type { AuthContext } from '../core/auth.js';
+import { type AppConfig } from '../core/config.js';
+import { UpstreamManager } from '../core/upstream.js';
+import type { Plugin } from './define.js';
+import { normalizeResult } from './result.js';
+export interface ToolStatus {
+    name: string;
+    enabled: boolean;
+    reason?: string;
+}
+export interface PluginStatus {
+    id: string;
+    description?: string;
+    enabled: boolean;
+    reason?: string;
+    tools: ToolStatus[];
+    upstreams: string[];
+}
+/** The core `ping` tool. It belongs to no group and is always allowed. */
+export declare const PING = "ping";
+export declare class Registry {
+    readonly plugins: Plugin[];
+    readonly upstreams: UpstreamManager;
+    private readonly entries;
+    private readonly pluginConfig;
+    /** Remote tool names already reported as shadowed by a local tool (log once). */
+    private readonly warned;
+    private readonly upstreamGroups;
+    private readonly config;
+    constructor(plugins: Plugin[], config?: AppConfig);
+    private parsePluginConfig;
+    private collectUpstreams;
+    /** true, or why the plugin is off (missing env names, failed check). */
+    pluginEnabled(p: Plugin): true | string;
+    private toolEnabled;
+    status(): PluginStatus[];
+    /** One line for the boot log: drive=on slack=off ... */
+    summary(): string;
+    /** Server instructions: config branding.instructions, or the base line plus each enabled plugin's notes. */
+    instructions(): string;
+    /** Permission group of a tool: plugin id, upstream group, or null (ping, unknown names). */
+    groupOf(name: string): string | null;
+    /** Every tool to show (before permission filtering): ping, enabled local tools, connected remote tools. */
+    listTools(pingTool: McpTool): McpTool[];
+    /** Validate, run and normalize. Permission is checked by the caller (server/mcp.ts) before this. */
+    call(name: string, args: Record<string, unknown> | undefined, auth: AuthContext): Promise<ReturnType<typeof normalizeResult>>;
+    /**
+     * After listen: connect remotes and, on HTTP, run plugin start hooks (background jobs such as the Drive
+     * sync). stdio skips the hooks: every client session spawns its own process and would start its own jobs.
+     * Failures are logged and skipped.
+     */
+    start(opts?: {
+        jobs: boolean;
+    }): Promise<void>;
+}

package/dist/plugin/registry.js

@@ -0,0 +1,248 @@
+import { safeParse } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import { getConfig, BASE_INSTRUCTIONS } from '../core/config.js';
+import { UpstreamManager } from '../core/upstream.js';
+import { isSet } from '../core/env.js';
+import { getStore } from '../store/index.js';
+import { errorResult, formatValidationError, inputJsonSchema, normalizeResult, textResult } from './result.js';
+/** The core `ping` tool. It belongs to no group and is always allowed. */
+export const PING = 'ping';
+function check(fn) {
+    if (!fn)
+        return true;
+    try {
+        const r = fn();
+        if (r === true)
+            return true;
+        return typeof r === 'string' && r ? r : 'disabled';
+    }
+    catch (e) {
+        return `check failed: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+function stateFor(namespace) {
+    return {
+        get: async (key) => (await (await getStore()).getState(namespace, key)),
+        set: async (key, value) => (await getStore()).setState(namespace, key, value),
+        delete: async (key) => (await getStore()).deleteState(namespace, key),
+    };
+}
+export class Registry {
+    plugins;
+    upstreams;
+    entries = new Map();
+    pluginConfig = new Map();
+    /** Remote tool names already reported as shadowed by a local tool (log once). */
+    warned = new Set();
+    upstreamGroups = new Map();
+    config;
+    constructor(plugins, config = getConfig()) {
+        this.plugins = plugins;
+        this.config = config;
+        const ids = new Set();
+        for (const p of plugins) {
+            if (ids.has(p.id))
+                throw new Error(`[plugin] two plugins use the id "${p.id}"`);
+            ids.add(p.id);
+            for (const t of p.tools ?? []) {
+                if (t.name === PING)
+                    throw new Error(`[plugin] ${p.id}: the tool name "ping" is reserved`);
+                const other = this.entries.get(t.name);
+                if (other)
+                    throw new Error(`[plugin] tool "${t.name}" is defined by both "${other.plugin.id}" and "${p.id}"`);
+                this.entries.set(t.name, { plugin: p, tool: t, inputSchema: inputJsonSchema(t.name, t.input) });
+            }
+            this.pluginConfig.set(p.id, this.parsePluginConfig(p));
+        }
+        for (const u of config.upstreams) {
+            if (ids.has(u.name))
+                throw new Error(`[config] upstream "${u.name}" has the same name as a plugin; pick another name`);
+        }
+        const remotes = this.collectUpstreams();
+        for (const r of remotes)
+            this.upstreamGroups.set(r.spec.name, r.group);
+        this.upstreams = new UpstreamManager(remotes);
+    }
+    parsePluginConfig(p) {
+        const raw = this.config.plugins[p.id];
+        if (!p.configSchema)
+            return raw;
+        const r = safeParse(p.configSchema, raw ?? {});
+        if (!r.success)
+            throw new Error(`[config] plugins.${p.id}: ${formatValidationError(r.error)}`);
+        return r.data;
+    }
+    collectUpstreams() {
+        const out = [];
+        for (const p of this.plugins) {
+            if (!p.upstreams || this.pluginEnabled(p) !== true)
+                continue;
+            const specs = typeof p.upstreams === 'function' ? p.upstreams() : p.upstreams;
+            for (const spec of specs)
+                out.push({ spec, group: p.id });
+        }
+        for (const u of this.config.upstreams) {
+            out.push({
+                group: u.name,
+                spec: {
+                    name: u.name,
+                    url: u.url,
+                    prefix: u.prefix ?? `${u.name.replace(/-/g, '_')}_`,
+                    token: u.tokenEnv ? () => process.env[u.tokenEnv] : undefined,
+                    headers: u.headers,
+                    expose: u.expose,
+                },
+            });
+        }
+        return out;
+    }
+    /** true, or why the plugin is off (missing env names, failed check). */
+    pluginEnabled(p) {
+        const missing = (p.env ?? []).filter((name) => !isSet(process.env[name]));
+        if (missing.length)
+            return `missing env ${missing.join(', ')}`;
+        return check(p.enabled);
+    }
+    toolEnabled(e) {
+        const pe = this.pluginEnabled(e.plugin);
+        return pe === true ? check(e.tool.enabled) : pe;
+    }
+    status() {
+        return this.plugins.map((p) => {
+            const pe = this.pluginEnabled(p);
+            return {
+                id: p.id,
+                description: p.description,
+                enabled: pe === true,
+                reason: pe === true ? undefined : pe,
+                tools: (p.tools ?? []).map((t) => {
+                    const te = this.toolEnabled(this.entries.get(t.name));
+                    return { name: t.name, enabled: te === true, reason: te === true ? undefined : te };
+                }),
+                upstreams: [...this.upstreamGroups].filter(([, g]) => g === p.id).map(([name]) => name),
+            };
+        });
+    }
+    /** One line for the boot log: drive=on slack=off ... */
+    summary() {
+        const parts = this.status().map((s) => {
+            if (!s.enabled)
+                return `${s.id}=off`;
+            const off = s.tools.filter((t) => !t.enabled).length;
+            return off ? `${s.id}=on(${s.tools.length - off}/${s.tools.length})` : `${s.id}=on`;
+        });
+        const remote = this.config.upstreams.map((u) => `${u.name}=remote`);
+        return [...parts, ...remote].join(' ') || '(no plugins)';
+    }
+    /** Server instructions: config branding.instructions, or the base line plus each enabled plugin's notes. */
+    instructions() {
+        if (this.config.branding.instructions)
+            return this.config.branding.instructions;
+        const notes = this.plugins
+            .filter((p) => p.instructions && this.pluginEnabled(p) === true)
+            .map((p) => `- ${p.instructions.trim()}`);
+        return notes.length ? `${BASE_INSTRUCTIONS}\n\n${notes.join('\n')}` : BASE_INSTRUCTIONS;
+    }
+    /** Permission group of a tool: plugin id, upstream group, or null (ping, unknown names). */
+    groupOf(name) {
+        const e = this.entries.get(name);
+        if (e)
+            return e.plugin.id;
+        return this.upstreams.owner(name)?.group ?? null;
+    }
+    /** Every tool to show (before permission filtering): ping, enabled local tools, connected remote tools. */
+    listTools(pingTool) {
+        const out = [pingTool];
+        for (const e of this.entries.values()) {
+            if (this.toolEnabled(e) !== true)
+                continue;
+            out.push({
+                name: e.tool.name,
+                description: e.tool.description,
+                inputSchema: e.inputSchema,
+                ...(e.tool.annotations ? { annotations: e.tool.annotations } : {}),
+            });
+        }
+        for (const { tool } of this.upstreams.tools()) {
+            if (this.entries.has(tool.name) || tool.name === PING) {
+                if (!this.warned.has(tool.name)) {
+                    this.warned.add(tool.name);
+                    console.error(`[upstream] remote tool ${tool.name} hidden: a local tool has the same name`);
+                }
+                continue;
+            }
+            out.push(tool);
+        }
+        return out;
+    }
+    /** Validate, run and normalize. Permission is checked by the caller (server/mcp.ts) before this. */
+    async call(name, args, auth) {
+        const e = this.entries.get(name);
+        if (e) {
+            const enabled = this.toolEnabled(e);
+            if (enabled !== true)
+                return textResult(`[error] 도구 '${name}' 이 설정되지 않았습니다 (${enabled}).`, true);
+            const parsed = e.tool.input ? safeParse(e.tool.input, args ?? {}) : { success: true, data: args ?? {} };
+            if (!parsed.success) {
+                return textResult(`[invalid_input] 도구 '${name}' 입력이 스키마에 맞지 않습니다 — ${formatValidationError(parsed.error)}`, true);
+            }
+            const ctx = {
+                user: { email: auth.email, role: auth.role ?? 'viewer', keyId: auth.key_id },
+                auth,
+                config: this.pluginConfig.get(e.plugin.id),
+                state: stateFor(e.plugin.id),
+                log: (...a) => console.error(`[${e.plugin.id}]`, ...a),
+            };
+            try {
+                return normalizeResult(await e.tool.run(parsed.data, ctx));
+            }
+            catch (err) {
+                return errorResult(name, err);
+            }
+        }
+        const remote = this.upstreams.owner(name);
+        if (remote) {
+            try {
+                return (await remote.call(args ?? {}));
+            }
+            catch (err) {
+                return errorResult(name, err);
+            }
+        }
+        const blockedBy = this.upstreams.prefixOwner(name);
+        if (blockedBy) {
+            console.error(`[upstream] blocked (not exposed by the read-only gateway): ${name}`);
+            return textResult(`[forbidden] write/미허용 도구는 비활성화됨(read-only gateway): ${name}`, true);
+        }
+        return textResult(`Unknown tool: ${name}`, true);
+    }
+    /**
+     * After listen: connect remotes and, on HTTP, run plugin start hooks (background jobs such as the Drive
+     * sync). stdio skips the hooks: every client session spawns its own process and would start its own jobs.
+     * Failures are logged and skipped.
+     */
+    async start(opts = { jobs: true }) {
+        try {
+            await this.upstreams.connectAll();
+        }
+        catch (e) {
+            console.error('[knowledge-mcp] upstream connect failed (local tools keep working):', e);
+        }
+        if (!opts.jobs)
+            return;
+        for (const p of this.plugins) {
+            if (!p.start || this.pluginEnabled(p) !== true)
+                continue;
+            try {
+                await p.start({
+                    config: this.pluginConfig.get(p.id),
+                    state: stateFor(p.id),
+                    log: (...a) => console.error(`[${p.id}]`, ...a),
+                });
+            }
+            catch (e) {
+                console.error(`[${p.id}] start failed (plugin tools stay listed):`, e);
+            }
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugin/registry.js.map

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

package/dist/plugin/result.d.ts

@@ -0,0 +1,20 @@
+import type { AnySchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import { type ToolResult, type ToolReturn } from './define.js';
+export type JsonSchemaObject = {
+    type: 'object';
+    properties?: Record<string, unknown>;
+    [k: string]: unknown;
+};
+export declare function textResult(text: string, isError?: boolean): ToolResult;
+/** string → text, MCP result → as is, anything else → pretty JSON text. */
+export declare function normalizeResult(v: ToolReturn): ToolResult;
+/** zod 3 and zod 4 errors both carry `issues` with path and message. */
+export declare function formatValidationError(err: unknown): string;
+export declare function isValidationError(err: unknown): boolean;
+/** Map a thrown error to a result the model can read. */
+export declare function errorResult(toolName: string, err: unknown): ToolResult;
+/**
+ * zod object schema → JSON Schema for tools/list. Unlike the SDK's McpServer, this keeps the properties of
+ * schemas wrapped in `.refine()` (zod 3 effects). Fails at boot when the input is not an object.
+ */
+export declare function inputJsonSchema(toolName: string, schema: AnySchema | undefined): JsonSchemaObject;

package/dist/plugin/result.js

@@ -0,0 +1,59 @@
+/**
+ * Turns what a tool returns (or throws) into an MCP CallTool result, and zod schemas into JSON Schema.
+ */
+import { toJsonSchemaCompat } from '@modelcontextprotocol/sdk/server/zod-json-schema-compat.js';
+import { ToolError } from './define.js';
+const EMPTY_INPUT = { type: 'object', properties: {} };
+export function textResult(text, isError = false) {
+    return isError ? { content: [{ type: 'text', text }], isError: true } : { content: [{ type: 'text', text }] };
+}
+function isToolResult(v) {
+    return !!v && typeof v === 'object' && Array.isArray(v.content);
+}
+/** string → text, MCP result → as is, anything else → pretty JSON text. */
+export function normalizeResult(v) {
+    if (typeof v === 'string')
+        return textResult(v);
+    if (isToolResult(v))
+        return v;
+    if (v === undefined)
+        return textResult('(no result)');
+    return textResult(JSON.stringify(v, null, 2));
+}
+/** zod 3 and zod 4 errors both carry `issues` with path and message. */
+export function formatValidationError(err) {
+    const issues = err?.issues;
+    if (Array.isArray(issues) && issues.length) {
+        return issues.map((i) => `${(i.path ?? []).map(String).join('.') || '(root)'}: ${i.message ?? 'invalid'}`).join('; ');
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+export function isValidationError(err) {
+    const name = err?.name;
+    return (name === 'ZodError' || name === '$ZodError') && Array.isArray(err.issues);
+}
+/** Map a thrown error to a result the model can read. */
+export function errorResult(toolName, err) {
+    if (isValidationError(err)) {
+        return textResult(`[invalid_input] 도구 '${toolName}' 입력이 스키마에 맞지 않습니다 — ${formatValidationError(err)}`, true);
+    }
+    if (err instanceof ToolError)
+        return textResult(`[error] ${err.message}`, true);
+    const msg = err instanceof Error ? err.message : String(err);
+    return textResult(`[fatal] ${msg}`, true);
+}
+/**
+ * zod object schema → JSON Schema for tools/list. Unlike the SDK's McpServer, this keeps the properties of
+ * schemas wrapped in `.refine()` (zod 3 effects). Fails at boot when the input is not an object.
+ */
+export function inputJsonSchema(toolName, schema) {
+    if (!schema)
+        return EMPTY_INPUT;
+    const json = toJsonSchemaCompat(schema, { strictUnions: true, pipeStrategy: 'input' });
+    delete json.$schema;
+    if (json.type !== 'object') {
+        throw new Error(`[plugin] tool "${toolName}": input must be a zod object schema (z.object({...}))`);
+    }
+    return json;
+}
+//# sourceMappingURL=result.js.map

package/dist/plugin/result.js.map

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

package/dist/plugins/drive/chunker.d.ts

@@ -0,0 +1,28 @@
+export interface RawChunk {
+    heading: string;
+    content: string;
+    tokens: number;
+    image_urls: string[];
+    table_count: number;
+    has_code_block: boolean;
+    doc_status: string | null;
+    doc_tier: string | null;
+    doc_date: string | null;
+    doc_authors: string[];
+    doc_related: string[];
+    doc_tags: string[];
+    doc_source_refs: string[];
+    doc_affects: string[];
+    doc_products: string[];
+    doc_type: string | null;
+    doc_confidence: string | null;
+}
+export interface ParsedDoc {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parseFrontmatter(markdown: string): ParsedDoc;
+/**
+ * 전체 markdown → 청크 array. heading context + 이미지/표/코드/frontmatter 메타 보존.
+ */
+export declare function chunkMarkdown(markdown: string): RawChunk[];