@chnxthr/knowledge-mcp 0.0.0-stage → 0.3.0

package/dist/core/config.js.map

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

package/dist/core/context.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AsyncLocalStorage 기반 request-scoped AuthContext.
+ *
+ * HTTP transport 에선 per-request 마다 다른 사용자가 호출 →
+ * Express middleware 에서 authStore.run() 안에 transport.handleRequest() 감싸면
+ * tool handler 가 getAuth() 로 현재 호출자 확인 가능.
+ *
+ * stdio transport 에선 한 프로세스 = 한 사용자라 setProcessAuth() 로 프로세스 전체 값을 둔다.
+ * (enterWith 는 그 뒤에 생기는 비동기 작업에만 전파되고, stdin 핸들은 그 전에 만들어져
+ *  도구 호출 콜백에서 getStore() 가 비어 모든 호출이 거부됐다.)
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+import type { AuthContext } from './auth.js';
+export declare const authStore: AsyncLocalStorage<AuthContext>;
+/** stdio 시작 시 1회 — 이 프로세스의 모든 도구 호출이 이 인증으로 처리된다. */
+export declare function setProcessAuth(auth: AuthContext): void;
+/**
+ * 현재 request 의 AuthContext 반환. 없거나 ok=false 면 throw.
+ * Tool handler 안에서 호출.
+ */
+export declare function getAuth(): AuthContext;
+/**
+ * 옵션: ok 여부 무관하게 반환. middleware error response 생성 시 사용.
+ */
+export declare function getAuthMaybe(): AuthContext | undefined;

package/dist/core/context.js

@@ -0,0 +1,37 @@
+/**
+ * AsyncLocalStorage 기반 request-scoped AuthContext.
+ *
+ * HTTP transport 에선 per-request 마다 다른 사용자가 호출 →
+ * Express middleware 에서 authStore.run() 안에 transport.handleRequest() 감싸면
+ * tool handler 가 getAuth() 로 현재 호출자 확인 가능.
+ *
+ * stdio transport 에선 한 프로세스 = 한 사용자라 setProcessAuth() 로 프로세스 전체 값을 둔다.
+ * (enterWith 는 그 뒤에 생기는 비동기 작업에만 전파되고, stdin 핸들은 그 전에 만들어져
+ *  도구 호출 콜백에서 getStore() 가 비어 모든 호출이 거부됐다.)
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+export const authStore = new AsyncLocalStorage();
+// stdio 전용 프로세스 단위 인증. HTTP 에서는 설정하지 않는다(요청마다 authStore.run).
+let _processAuth;
+/** stdio 시작 시 1회 — 이 프로세스의 모든 도구 호출이 이 인증으로 처리된다. */
+export function setProcessAuth(auth) {
+    _processAuth = auth;
+}
+/**
+ * 현재 request 의 AuthContext 반환. 없거나 ok=false 면 throw.
+ * Tool handler 안에서 호출.
+ */
+export function getAuth() {
+    const auth = authStore.getStore() ?? _processAuth;
+    if (!auth || !auth.ok) {
+        throw new Error('[context] auth not initialized or not ok');
+    }
+    return auth;
+}
+/**
+ * 옵션: ok 여부 무관하게 반환. middleware error response 생성 시 사용.
+ */
+export function getAuthMaybe() {
+    return authStore.getStore() ?? _processAuth;
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAe,CAAC;AAE9D,8DAA8D;AAC9D,IAAI,YAAqC,CAAC;AAE1C,qDAAqD;AACrD,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,YAAY,CAAC;IAClD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,QAAQ,EAAE,IAAI,YAAY,CAAC;AAC9C,CAAC"}

package/dist/core/env.d.ts

@@ -0,0 +1,2 @@
+/** An env value counts as set only when it has non-space content (an empty `FOO=` line in .env is unset). */
+export declare function isSet(v: string | undefined): boolean;

package/dist/core/env.js

@@ -0,0 +1,5 @@
+/** An env value counts as set only when it has non-space content (an empty `FOO=` line in .env is unset). */
+export function isSet(v) {
+    return !!v && v.trim().length > 0;
+}
+//# sourceMappingURL=env.js.map

package/dist/core/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAC7G,MAAM,UAAU,KAAK,CAAC,CAAqB;IACzC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/core/log_mask.d.ts

@@ -0,0 +1,10 @@
+/** 문자열에서 시크릿(구체값 + 일반 패턴)을 [REDACTED] 로 가린다. */
+export declare function maskString(input: string): string;
+/**
+ * console.{log,error,warn,info,debug} 를 마스킹 래퍼로 교체 (1회).
+ * .env 를 읽은 직후·다른 로직 전에 호출해야 이후 모든 로그가 마스킹된다(bootstrap.ts).
+ * 화면에 그대로 보여야 하는 값(새 API 키)은 console 이 아니라 process.stdout.write 로 쓴다.
+ */
+export declare function installLogMasking(): void;
+/** 부팅 로그 한 줄용 — 마스킹 중인 env 시크릿 개수. */
+export declare function maskedSecretCount(): number;

package/dist/core/log_mask.js

@@ -0,0 +1,88 @@
+/**
+ * 전역 로그 마스킹 — console.* 출력에서 시크릿을 가린다.
+ *
+ * 왜: 에러 객체(gaxios/fetch 의 request config·Authorization 헤더, Qdrant·Slack·upstream
+ * 에러, uncaughtException/unhandledRejection stack)를 통째로 로깅할 때 토큰·API 키가 평문으로
+ * Railway 로그에 남을 수 있다. 노출 지점을 하나씩 막는 대신 console 진입을 한 곳에서 가로채
+ * 마스킹한다(포괄·방어적).
+ *
+ * 2축 마스킹:
+ *  1) 구체값 — process.env 의 민감 키 값(길이 ≥ 10)을 정확 매칭으로 제거. 가장 확실(키 자체를 지움).
+ *  2) 패턴   — sk-/AIza/Bearer/xox/gh*_/JWT/api_key=/PEM private key 등 일반 시크릿 형태.
+ *
+ * fail-open: 마스킹 중 오류가 나도 원본 로깅은 보장한다(보안 기능이 로깅 자체를 깨면 안 됨).
+ */
+import { inspect } from 'util';
+const REDACTED = '[REDACTED]';
+/** 값이 시크릿일 가능성이 큰 env 키 이름. PAT 은 단어 단위로만(PATH 같은 이름 오탐 방지). */
+const SECRET_KEY_NAME = /(KEY|TOKEN|SECRET|PASSWORD|CREDENTIAL|PRIVATE|REFRESH|SIGNING)|(^|_)PAT($|_)/i;
+/** false-positive 방지 — 키 이름이 위에 걸려도 값이 흔한 비밀-아님이면 제외 */
+const SAFE_VALUES = new Set(['true', 'false', 'production', 'development', 'http', 'https', 'none', 'null']);
+let _installed = false;
+let _envSecretRe = null;
+let _envSecretCount = 0;
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** process.env 에서 마스킹할 구체 시크릿 값을 모은다 (길이 내림차순 — 긴 값 먼저 치환). */
+function collectEnvSecrets() {
+    const out = [];
+    for (const [k, v] of Object.entries(process.env)) {
+        if (!v || v.length < 10)
+            continue;
+        if (SAFE_VALUES.has(v.toLowerCase()))
+            continue;
+        if (SECRET_KEY_NAME.test(k))
+            out.push(v);
+    }
+    return [...new Set(out)].sort((a, b) => b.length - a.length);
+}
+/** 문자열에서 시크릿(구체값 + 일반 패턴)을 [REDACTED] 로 가린다. */
+export function maskString(input) {
+    if (!input)
+        return input;
+    let out = input;
+    // 1) env 구체값 (가장 확실)
+    if (_envSecretRe)
+        out = out.replace(_envSecretRe, REDACTED);
+    // 2) 일반 패턴
+    out = out.replace(/-----BEGIN[A-Z ]*PRIVATE KEY-----[\s\S]*?-----END[A-Z ]*PRIVATE KEY-----/g, '[REDACTED PRIVATE KEY]');
+    out = out.replace(/eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{6,}\.[A-Za-z0-9_-]{4,}/g, REDACTED); // JWT
+    out = out.replace(/\b(sk-[A-Za-z0-9_-]{8,}|AIza[A-Za-z0-9_-]{10,}|xox[bpsar]-[A-Za-z0-9-]{8,}|gh[pousr]_[A-Za-z0-9]{16,}|github_pat_[A-Za-z0-9_]{20,}|kmcp_[A-Za-z0-9_-]{20,})/g, REDACTED);
+    out = out.replace(/\bBearer\s+[A-Za-z0-9._~+/-]{12,}=*/gi, `Bearer ${REDACTED}`);
+    out = out.replace(/\b(api[-_]?key|access[-_]?token|refresh[-_]?token|client[-_]?secret|authorization)(["':=\s]+)[A-Za-z0-9._-]{8,}/gi, (_m, key, sep) => `${key}${sep}${REDACTED}`);
+    return out;
+}
+/**
+ * console.{log,error,warn,info,debug} 를 마스킹 래퍼로 교체 (1회).
+ * .env 를 읽은 직후·다른 로직 전에 호출해야 이후 모든 로그가 마스킹된다(bootstrap.ts).
+ * 화면에 그대로 보여야 하는 값(새 API 키)은 console 이 아니라 process.stdout.write 로 쓴다.
+ */
+export function installLogMasking() {
+    if (_installed)
+        return;
+    _installed = true;
+    const secrets = collectEnvSecrets();
+    _envSecretCount = secrets.length;
+    _envSecretRe = secrets.length ? new RegExp(secrets.map(escapeRegExp).join('|'), 'g') : null;
+    const methods = ['log', 'error', 'warn', 'info', 'debug'];
+    for (const m of methods) {
+        const orig = console[m].bind(console);
+        console[m] = (...args) => {
+            try {
+                const masked = args.map((a) => typeof a === 'string'
+                    ? maskString(a)
+                    : maskString(inspect(a, { depth: 4, breakLength: Infinity })));
+                orig(...masked);
+            }
+            catch {
+                orig(...args); // fail-open — 마스킹 실패가 로깅을 막지 않음
+            }
+        };
+    }
+}
+/** 부팅 로그 한 줄용 — 마스킹 중인 env 시크릿 개수. */
+export function maskedSecretCount() {
+    return _envSecretCount;
+}
+//# sourceMappingURL=log_mask.js.map

package/dist/core/log_mask.js.map

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

package/dist/core/oauth.d.ts

@@ -0,0 +1,46 @@
+import type { Response } from 'express';
+import type { OAuthServerProvider, AuthorizationParams } from '@modelcontextprotocol/sdk/server/auth/provider.js';
+import type { OAuthRegisteredClientsStore } from '@modelcontextprotocol/sdk/server/auth/clients.js';
+import type { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+import type { OAuthClientInformationFull, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+export declare const CONSENT_COOKIE = "kmcp_consent";
+export declare const CONSENT_PATH = "/oauth/consent";
+/** OAuth 를 켜는 데 빠진 값 목록 (이름만, 값은 노출 안 함). 빈 배열이면 켤 수 있다. */
+export declare function oauthConfigProblems(): string[];
+/** OAuth 를 하나라도 설정하려 한 흔적이 있는가 — 반쯤 설정된 상태를 부팅 로그에서 크게 알리기 위함. */
+export declare function oauthAttempted(): boolean;
+/** OAuth 활성 조건 — 필수 값이 모두 있어야 함. 없으면 index 가 라우터 미장착(기존 Bearer 유지). */
+export declare function isOAuthConfigured(): boolean;
+export declare const OAUTH_ISSUER_URL: string;
+export declare const OAUTH_RESOURCE: string;
+export declare const OAUTH_SCOPES: string[];
+export declare class KnowledgeOAuthProvider implements OAuthServerProvider {
+    private _clients;
+    get clientsStore(): OAuthRegisteredClientsStore;
+    skipLocalPkceValidation: boolean;
+    /**
+     * authorize: 동의 화면을 먼저 보여 준다. 승인(POST /oauth/consent)이 와야 Google 로그인으로 넘긴다.
+     * 우리 code 는 Google 콜백에서 발급.
+     */
+    authorize(client: OAuthClientInformationFull, params: AuthorizationParams, res: Response): Promise<void>;
+    /**
+     * 동의 화면의 POST 처리 (server/http.ts 의 POST /oauth/consent 가 호출). 돌려줄 redirect URL 을 반환한다.
+     * 승인: 폼 csrf·쿠키 csrf·저장된 csrf 가 모두 같을 때만 Google 로그인으로. 거절: client 로 access_denied.
+     * 검증 실패는 throw — 호출부가 400 으로 끝낸다(공격자 redirect_uri 로 보내지 않는다).
+     */
+    consumeConsent(id: string, formCsrf: string, cookieCsrf: string, approve: boolean): string;
+    /** Google 로그인 URL 을 만들고 state 를 기록한다. */
+    private googleRedirect;
+    /**
+     * Google 콜백 처리 (server/http.ts 의 /oauth/google/callback 라우트가 호출).
+     * 성공/실패 모두 client redirect_uri 로 돌려보낼 URL 을 반환한다.
+     */
+    completeGoogleLogin(googleCode: string, state: string): Promise<string>;
+    challengeForAuthorizationCode(_client: OAuthClientInformationFull, authorizationCode: string): Promise<string>;
+    exchangeAuthorizationCode(client: OAuthClientInformationFull, authorizationCode: string, _codeVerifier?: string, // SDK 가 challengeForAuthorizationCode 와 PKCE 검증 완료
+    redirectUri?: string, _resource?: URL): Promise<OAuthTokens>;
+    exchangeRefreshToken(client: OAuthClientInformationFull, refreshToken: string, scopes?: string[], _resource?: URL): Promise<OAuthTokens>;
+    /** RS: access token 검증 (requireBearerAuth + 우리 /mcp dual-auth 가 사용) */
+    verifyAccessToken(token: string): Promise<AuthInfo>;
+}
+export declare const oauthProvider: KnowledgeOAuthProvider;