korean-law-mcp 4.4.3 → 4.4.4

package/README.md

@@ -22,6 +22,12 @@
 
 ---
 
+## v4.4.1–4.4.3 — 안정성 패치
+
+- **v4.4.3**: `zod`를 `^4`로 고정 — 신규 설치가 zod 3.x를 해석해 `listTools` 첫 호출에서 `z.toJSONSchema is not a function`으로 크래시하던 문제 해결
+- **v4.4.2**: `get_annexes` 행정규칙 별표/서식 조회 복구 — 응답 키 `admrulbyl` 우선 파싱 + "...시행세칙" 자동 판별 + 동일 bylSeq 별표/서식 충돌 분리 (#50/#49/#51)
+- **v4.4.1**: 광고 스키마 `required` 버그 수정 — `.default()` 필드(`legal_research.task`·`search_law.display`)가 필수 입력으로 노출되던 문제(`io:"input"` 명시) + `legal_analysis` 비용 옵션 패스스루 + 비호환 scenario 경고 노트
+
 ## v4.4.0 — 노출 도구 통폐합 19개 → 9개 (컨텍스트 52% 감축)
 
 MCP 클라이언트가 매 세션 읽는 도구 목록(ListTools)을 ~15.1KB → ~7.2KB로 줄였습니다.

package/build/server/sse-server.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Streamable HTTP 서버 - 리모트 배포용 (MCP 2025-03-26 스펙 준수)
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function startSSEServer(server: Server, port: number): Promise<void>;

package/build/server/sse-server.js

@@ -0,0 +1,232 @@
+/**
+ * Streamable HTTP 서버 - 리모트 배포용 (MCP 2025-03-26 스펙 준수)
+ */
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { InMemoryEventStore } from "@modelcontextprotocol/sdk/examples/shared/inMemoryEventStore.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { sessionStore, setSessionApiKey, deleteSession } from "../lib/session-state.js";
+import { VERSION } from "../version.js";
+export async function startSSEServer(server, port) {
+    const app = express();
+    const transports = {};
+    // JSON 파싱 미들웨어 (크기 제한 명시)
+    app.use(express.json({ limit: "100kb" }));
+    // 유휴 세션 정리 (30분)
+    const SESSION_IDLE_TIMEOUT = 30 * 60 * 1000;
+    const MAX_SESSIONS = 100;
+    setInterval(() => {
+        const now = Date.now();
+        for (const sid of Object.keys(transports)) {
+            const session = transports[sid];
+            if (session.lastAccess && now - session.lastAccess > SESSION_IDLE_TIMEOUT) {
+                try {
+                    session.transport.close();
+                }
+                catch { /* ignore */ }
+                delete transports[sid];
+                deleteSession(sid);
+            }
+        }
+    }, 5 * 60 * 1000).unref();
+    // CORS 및 보안 헤더 설정
+    const corsOrigin = process.env.CORS_ORIGIN || "*";
+    app.use((req, res, next) => {
+        res.header("Access-Control-Allow-Origin", corsOrigin);
+        res.header("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS, HEAD");
+        res.header("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization, Mcp-Protocol-Version, mcp-protocol-version, Mcp-Session-Id, mcp-session-id, Last-Event-ID, last-event-id, Traceparent, Tracestate");
+        res.header("Access-Control-Expose-Headers", "Mcp-Session-Id, Content-Type, Mcp-Protocol-Version, Traceparent, Tracestate");
+        res.header("Access-Control-Max-Age", "86400");
+        // Security headers (http-server.ts와 동일)
+        res.header("X-Content-Type-Options", "nosniff");
+        res.header("X-Frame-Options", "DENY");
+        res.header("Referrer-Policy", "strict-origin-when-cross-origin");
+        res.header("Mcp-Protocol-Version", "2025-03-26");
+        if (req.method === "OPTIONS") {
+            return res.sendStatus(200);
+        }
+        next();
+    });
+    // 헬스체크 엔드포인트
+    app.get("/", (req, res) => {
+        res.json({
+            name: "Korean Law MCP Server",
+            version: VERSION,
+            status: "running",
+            protocol: "streamable-http",
+            endpoints: {
+                mcp: "/mcp",
+                health: "/health"
+            }
+        });
+    });
+    app.get("/health", (req, res) => {
+        res.json({ status: "ok", timestamp: new Date().toISOString() });
+    });
+    // MCP POST 엔드포인트 (초기화 및 요청 처리)
+    app.post("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        // API 키 추출 (http-server.ts와 동일 패턴)
+        const apiKeyFromHeader = req.headers["apikey"] ||
+            req.headers["law_oc"] ||
+            req.headers["law-oc"] ||
+            req.headers["LAW_OC"] ||
+            req.headers["x-api-key"] ||
+            req.headers["authorization"]?.replace(/^Bearer\s+/i, "") ||
+            req.headers["x-law-oc"];
+        if (sessionId) {
+            console.error(`Received MCP request for session: ${sessionId.slice(0, 8)}...`);
+        }
+        else {
+            console.error("New MCP request (no session ID)");
+        }
+        try {
+            let transport;
+            if (sessionId && transports[sessionId]) {
+                // 기존 세션 재사용 + 접근 시각 갱신
+                ;
+                transports[sessionId].lastAccess = Date.now();
+                transport = transports[sessionId].transport;
+                // API 키 업데이트 (헤더에서 제공된 경우)
+                if (apiKeyFromHeader) {
+                    setSessionApiKey(sessionId, apiKeyFromHeader);
+                }
+                // AsyncLocalStorage로 세션 ID 격리 (동시 요청 안전)
+                await sessionStore.run(sessionId, async () => {
+                    await transport.handleRequest(req, res, req.body);
+                });
+                return;
+            }
+            else if (!sessionId && isInitializeRequest(req.body)) {
+                // 새 세션 초기화
+                // 세션 수 제한 — transport 생성 전에 체크하여 리소스 누수 방지
+                if (Object.keys(transports).length >= MAX_SESSIONS) {
+                    res.status(503).json({
+                        jsonrpc: "2.0",
+                        error: { code: -32000, message: `Max sessions (${MAX_SESSIONS}) reached. Try again later.` },
+                        id: null,
+                    });
+                    return;
+                }
+                const eventStore = new InMemoryEventStore();
+                transport = new StreamableHTTPServerTransport({
+                    sessionIdGenerator: () => randomUUID(),
+                    eventStore,
+                    onsessioninitialized: (newSessionId) => {
+                        transports[newSessionId] = { transport, lastAccess: Date.now() };
+                        if (apiKeyFromHeader) {
+                            setSessionApiKey(newSessionId, apiKeyFromHeader);
+                        }
+                    }
+                });
+                // 세션 종료 시 정리
+                transport.onclose = () => {
+                    const sid = transport.sessionId;
+                    if (sid && transports[sid]) {
+                        console.error(`Transport closed for session ${sid.slice(0, 8)}...`);
+                        delete transports[sid];
+                        deleteSession(sid);
+                    }
+                };
+                // 서버 연결
+                await server.connect(transport);
+                await transport.handleRequest(req, res, req.body);
+                return;
+            }
+            else {
+                // 잘못된 요청
+                res.status(400).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32000,
+                        message: "Invalid request: missing session ID or not an initialization request"
+                    },
+                    id: null
+                });
+                return;
+            }
+        }
+        catch (error) {
+            console.error("Error handling MCP POST request:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32603,
+                        message: "Internal server error"
+                    },
+                    id: null
+                });
+            }
+        }
+    });
+    // MCP GET 엔드포인트 (SSE 스트림)
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId || !transports[sessionId]) {
+            res.status(400).send("Invalid or missing session ID");
+            return;
+        }
+        const lastEventId = req.headers["last-event-id"];
+        if (lastEventId) {
+            console.error(`Client reconnecting with Last-Event-ID: ${lastEventId}`);
+        }
+        else {
+            console.error(`Establishing SSE stream for session ${sessionId.slice(0, 8)}...`);
+        }
+        try {
+            const transport = transports[sessionId].transport;
+            await transport.handleRequest(req, res);
+        }
+        catch (error) {
+            console.error("[GET /mcp] Error:", error);
+            if (!res.headersSent) {
+                res.status(500).send("Internal server error");
+            }
+        }
+    });
+    // MCP DELETE 엔드포인트 (세션 종료)
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (!sessionId || !transports[sessionId]) {
+            res.status(400).send("Invalid or missing session ID");
+            return;
+        }
+        console.error(`Session termination request for ${sessionId.slice(0, 8)}...`);
+        try {
+            const transport = transports[sessionId].transport;
+            await transport.handleRequest(req, res);
+            delete transports[sessionId];
+            deleteSession(sessionId);
+            console.error(`Session removed: ${sessionId.slice(0, 8)}...`);
+        }
+        catch (error) {
+            console.error("Error handling session termination:", error);
+            if (!res.headersSent) {
+                res.status(500).send("Error processing session termination");
+            }
+        }
+    });
+    // 서버 시작
+    app.listen(port, "0.0.0.0", () => {
+        console.error(`✓ Korean Law MCP server (Streamable HTTP) listening on port ${port}`);
+        console.error(`✓ MCP endpoint: http://0.0.0.0:${port}/mcp`);
+        console.error(`✓ Health check: http://0.0.0.0:${port}/health`);
+    });
+    // 종료 처리
+    process.on("SIGINT", async () => {
+        console.error("Shutting down server...");
+        for (const sessionId in transports) {
+            try {
+                await transports[sessionId].transport.close();
+                delete transports[sessionId];
+                deleteSession(sessionId);
+            }
+            catch (error) {
+                console.error(`Error closing transport ${sessionId}:`, error);
+            }
+        }
+        process.exit(0);
+    });
+}

package/build/tools/annex.js

@@ -293,8 +293,14 @@ function findMatchingAnnex(annexList, annexSelector, knd) {
         }
         return selectorNumbers.some((num) => titleMatchesAnnexNumber(annexTitle, num));
     });
-    if (matches.length === 0)
+    if (matches.length === 0) {
+        // 번호가 안 맞아도 별표가 유일 1건이면 그 별표를 정답으로 폴백.
+        // 여권법 시행령 '수수료 및 사무의 대행에 드는 비용(제39조 관련)'처럼 번호 없는 단일 별표는
+        // 모델이 "별표1" 등 임의 번호로 불러도 매칭 0건 → NOT_FOUND로 새는 대신 유일 별표를 반환.
+        if (annexList.length === 1)
+            return annexList[0];
         return undefined;
+    }
     if (matches.length === 1)
         return matches[0];
     // 별표번호 충돌 → 별표종류("별표"/"서식")로 구분

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "korean-law-mcp",
-  "version": "4.4.3",
+  "version": "4.4.4",
   "description": "법제처 42개 API → 9개 MCP 도구. 법령·판례·조례·조약 + 다단계 리서치(legal_research, 8 task) + 정밀분석(legal_analysis: 인용검증·판례생사·행위시법·영향그래프) + 시점 비교(time_travel) + 상황별 5단계 안내(action_plan) + 국세청 해석례(nts)",
   "type": "module",
   "main": "build/index.js",