easyread-mcp 0.1.0

package/dist/text/spans.js

@@ -0,0 +1,9 @@
+/** 원문에서 span 구간의 문자열을 잘라낸다. */
+export function sliceSpan(raw, span) {
+    return raw.slice(span.start, span.end);
+}
+/** span의 길이(UTF-16 단위). */
+export function spanLength(span) {
+    return span.end - span.start;
+}
+//# sourceMappingURL=spans.js.map

package/dist/text/spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.js","sourceRoot":"","sources":["../../src/text/spans.ts"],"names":[],"mappings":"AAEA,+BAA+B;AAC/B,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAU;IAC/C,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;AAC/B,CAAC"}

package/dist/text/types.js

@@ -0,0 +1,6 @@
+/**
+ * text/ 계층의 자료형. 인덱스는 모두 원문(raw)에 대한 UTF-16 오프셋이다
+ * (규칙 span 보고 기준과 일치. 이모지 등 서로게이트 쌍은 2로 계산된다).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/text/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/text/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/text/words.js

@@ -0,0 +1,20 @@
+/**
+ * 어절 분해. 공백(공백/탭/개행)으로 나눈 토큰을 span과 함께 돌려준다.
+ * 공백이 없는 URL·이메일은 자연히 1어절이 된다(03 §3 "URL은 어절 1개").
+ */
+export function tokenizeWords(text, offset = 0) {
+    const words = [];
+    const re = /\S+/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const start = offset + m.index;
+        words.push({ text: m[0], span: { start, end: start + m[0].length } });
+    }
+    return words;
+}
+/** 어절 수만 필요할 때의 경량 함수. */
+export function countWords(text) {
+    const m = text.match(/\S+/g);
+    return m === null ? 0 : m.length;
+}
+//# sourceMappingURL=words.js.map

package/dist/text/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../../src/text/words.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAM,GAAG,CAAC;IACpD,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,EAAE,GAAG,MAAM,CAAC;IAClB,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACnC,CAAC"}

package/dist/tools/analyze.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { parseText } from "../text/index.js";
+const MAX_CHARS = 50_000;
+const analyzeOutputSchema = z.object({
+    charCount: z.number(),
+    sentenceCount: z.number(),
+    paragraphCount: z.number(),
+    avgWordsPerSentence: z.number(),
+    maxSentence: z.object({ excerpt: z.string(), words: z.number(), index: z.number() }),
+    difficultWordCount: z.number(),
+    difficultWords: z.array(z.object({ word: z.string(), count: z.number() })),
+    numbersDetected: z.number(),
+});
+function formatAnalyze(r) {
+    return [
+        `글자 ${r.charCount}자 · 문장 ${r.sentenceCount}개 · 문단 ${r.paragraphCount}개`,
+        `문장당 평균 ${r.avgWordsPerSentence} 어절, 가장 긴 문장 ${r.maxSentence.words} 어절.`,
+        `어려운 낱말 ${r.difficultWordCount}회, 숫자 ${r.numbersDetected}개.`,
+    ].join("\n");
+}
+/**
+ * analyze_readability 도구를 등록한다(FR-02, 계약: 02 §3.1).
+ * 지표 계산만 하고 판정은 하지 않는다. 어려운 낱말은 주입된 dictionary로 집계한다.
+ */
+export function registerAnalyzeTool(server, dictionary) {
+    server.registerTool("analyze_readability", {
+        title: "가독성 분석",
+        description: "한국어 텍스트의 가독성 지표(글자·문장·문단 수, 평균 어절, 가장 긴 문장, 어려운 낱말, 숫자)를 계산한다. 쉬운 정보로 고치기 전후를 견주거나 어디부터 손볼지 정할 때 쓴다.",
+        inputSchema: {
+            text: z
+                .string()
+                .min(1, { message: "분석할 텍스트를 입력하세요." })
+                .max(MAX_CHARS, { message: "텍스트가 너무 깁니다(최대 50,000자)." })
+                .refine((s) => s.trim().length > 0, { message: "빈 텍스트입니다. 분석할 내용을 입력하세요." })
+                .describe("분석할 텍스트(1~50,000자)."),
+        },
+        outputSchema: analyzeOutputSchema.shape,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ text }) => {
+        const parsed = parseText(text);
+        const sentenceCount = parsed.sentences.length;
+        const totalWords = parsed.sentences.reduce((n, s) => n + s.wordCount, 0);
+        let maxSentence = { excerpt: "", words: 0, index: 0 };
+        for (const s of parsed.sentences) {
+            if (s.wordCount > maxSentence.words) {
+                maxSentence = { excerpt: s.text, words: s.wordCount, index: s.index };
+            }
+        }
+        const counts = new Map();
+        if (dictionary !== undefined) {
+            for (const s of parsed.sentences) {
+                for (const w of s.words) {
+                    if (dictionary.lookup(w.text) !== undefined) {
+                        counts.set(w.text, (counts.get(w.text) ?? 0) + 1);
+                    }
+                }
+            }
+        }
+        const difficultWords = [...counts].map(([word, count]) => ({ word, count }));
+        const result = {
+            charCount: [...text].length,
+            sentenceCount,
+            paragraphCount: parsed.paragraphs.length,
+            avgWordsPerSentence: sentenceCount === 0 ? 0 : Math.round((totalWords / sentenceCount) * 10) / 10,
+            maxSentence,
+            difficultWordCount: difficultWords.reduce((n, d) => n + d.count, 0),
+            difficultWords,
+            numbersDetected: (text.match(/\d+/g) ?? []).length,
+        };
+        return { content: [{ type: "text", text: formatAnalyze(result) }], structuredContent: result };
+    });
+}
+//# sourceMappingURL=analyze.js.map

package/dist/tools/analyze.js.map

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

package/dist/tools/guidelines.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { rules } from "../rules/index.js";
+// section → 규칙 그룹. '전체'는 모든 그룹, '절차'(PROC)는 수동 항목이라 등록 규칙이 없다.
+const SECTION_GROUP = {
+    문장: "SEN",
+    어휘: "VOC",
+    숫자: "NUM",
+    구성: "STR",
+    표기: "TYP",
+    정확성: "ACC",
+};
+// 영역별 지침 요약(Markdown). validation-checklist의 규칙을 사람이 읽을 안내로 옮긴 것.
+const SECTION_CONTENT = {
+    전체: "# 쉬운 정보 작성 지침\n\n문장·어휘·숫자·구성·표기·정확성 영역의 규칙을 지켜 쉽게 쓰세요. 각 영역은 개별 조회할 수 있습니다.",
+    문장: "# 문장 (SEN)\n\n- 한 문장에 한 가지 정보만 담고 짧게 씁니다.\n- 복문·피동·이중부정·명사화(‘~하는 것’)를 피합니다.",
+    어휘: "# 어휘 (VOC)\n\n- 어려운 한자어·외래어 대신 쉬운 말을 씁니다.\n- 전문용어·약어는 처음 나올 때 뜻을 풀어 줍니다. 지시어는 줄입니다.",
+    숫자: "# 숫자 (NUM)\n\n- 숫자는 아라비아 숫자로, 큰 수는 만/억 단위로 끊어 씁니다.\n- 상대적 날짜(‘익일’) 대신 정확한 날짜를 씁니다.",
+    구성: "# 구성 (STR)\n\n- 한 단락에 한 주제만 담고, 문장이 많으면 나눕니다.\n- 여러 항목 나열은 글머리표 목록으로 만듭니다.",
+    표기: "# 표기 (TYP)\n\n- 기호(※, ~, &, /)는 말로 풀어 씁니다.\n- 괄호·쌍점(:)·쌍반점(;)을 절제합니다.",
+    절차: "# 절차 (PROC)\n\n- 당사자(발달장애인)가 직접 확인·감수하도록 합니다. 자동 검사가 아닌 점검 항목입니다.",
+    정확성: "# 정확성 (ACC)\n\n- 원문의 날짜·금액·기관명·연락처를 바꾸거나 빠뜨리지 않습니다.\n- 쉽게 바꾸더라도 사실은 그대로 유지합니다.",
+};
+function ruleIdsFor(section) {
+    if (section === "전체")
+        return rules.map((r) => r.id);
+    const group = SECTION_GROUP[section];
+    if (group === undefined)
+        return []; // 절차(PROC) 등 등록 규칙이 없는 영역
+    return rules.filter((r) => r.group === group).map((r) => r.id);
+}
+/**
+ * get_guidelines 도구를 등록한다(FR-04, 계약: 02 §3.1).
+ * ruleIds는 등록된 규칙(registry)에서 파생 — validation-checklist가 규칙 ID의 단일 소스다.
+ */
+export function registerGuidelinesTool(server) {
+    server.registerTool("get_guidelines", {
+        title: "작성 지침 보기",
+        description: "쉬운 정보 작성 지침을 영역별로 돌려준다(문장·어휘·숫자·구성·표기·절차·정확성 또는 전체). 어떤 규칙을 지켜야 하는지 확인할 때 쓴다.",
+        inputSchema: {
+            section: z
+                .enum(["전체", "문장", "어휘", "숫자", "구성", "표기", "절차", "정확성"])
+                .describe("조회할 지침 영역."),
+        },
+        outputSchema: z.object({ section: z.string(), ruleIds: z.array(z.string()) }).shape,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ section }) => {
+        const ruleIds = ruleIdsFor(section);
+        const content = SECTION_CONTENT[section] ?? `# ${section}`;
+        return {
+            content: [{ type: "text", text: content }],
+            structuredContent: { section, ruleIds },
+        };
+    });
+}
+//# sourceMappingURL=guidelines.js.map

package/dist/tools/guidelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidelines.js","sourceRoot":"","sources":["../../src/tools/guidelines.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,+DAA+D;AAC/D,MAAM,aAAa,GAA2B;IAC5C,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,kEAAkE;AAClE,MAAM,eAAe,GAA2B;IAC9C,EAAE,EAAE,6EAA6E;IACjF,EAAE,EAAE,6EAA6E;IACjF,EAAE,EAAE,qFAAqF;IACzF,EAAE,EAAE,oFAAoF;IACxF,EAAE,EAAE,4EAA4E;IAChF,EAAE,EAAE,uEAAuE;IAC3E,EAAE,EAAE,mEAAmE;IACvE,GAAG,EAAE,gFAAgF;CACtF,CAAC;AAEF,SAAS,UAAU,CAAC,OAAe;IACjC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,CAAC,0BAA0B;IAC9D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EACT,+EAA+E;QACjF,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;iBACvD,QAAQ,CAAC,YAAY,CAAC;SAC1B;QACD,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK;QACnF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACd,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,iBAAiB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;SACxC,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/lookup.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+const DEFAULT_LIMIT = 5;
+const lookupOutputSchema = z.object({
+    found: z.boolean(),
+    entry: z
+        .object({
+        word: z.string(),
+        category: z.string(),
+        alternatives: z.array(z.string()),
+        explanation: z.string().optional(),
+        example: z.string().optional(),
+        source: z.string(),
+    })
+        .optional(),
+    related: z.array(z.object({ word: z.string(), category: z.string() })),
+});
+/**
+ * lookup_easy_word 도구를 등록한다(FR-03, 계약: 02 §3.1).
+ * 미등재어는 오류가 아니다 — found:false + 부분일치 후보(related)를 돌려준다.
+ */
+export function registerLookupTool(server, dictionary) {
+    server.registerTool("lookup_easy_word", {
+        title: "쉬운 낱말 찾기",
+        description: "낱말을 사전에서 찾아 쉬운 대체어·뜻풀이·예문을 돌려준다. 없으면 비슷한 낱말(related)을 함께 제안한다. 어려운 낱말을 쉬운 말로 바꿀 때 쓴다.",
+        inputSchema: {
+            word: z
+                .string()
+                .min(1, { message: "찾을 낱말을 입력하세요." })
+                .max(50, { message: "낱말이 너무 깁니다(최대 50자)." })
+                .describe("사전에서 찾을 낱말."),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(50)
+                .optional()
+                .describe(`관련어(related) 최대 개수(기본 ${DEFAULT_LIMIT}).`),
+        },
+        outputSchema: lookupOutputSchema.shape,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ word, limit }) => {
+        const max = limit ?? DEFAULT_LIMIT;
+        const entry = dictionary?.lookup(word);
+        const related = [];
+        if (dictionary !== undefined) {
+            for (const e of dictionary.entries) {
+                if (e.word === word)
+                    continue; // 자기 자신 제외
+                if (e.word.includes(word) || word.includes(e.word)) {
+                    related.push({ word: e.word, category: e.category });
+                    if (related.length >= max)
+                        break;
+                }
+            }
+        }
+        const found = entry !== undefined;
+        const structuredContent = {
+            found,
+            related,
+            ...(entry !== undefined
+                ? {
+                    entry: {
+                        word: entry.word,
+                        category: entry.category,
+                        alternatives: [...entry.alternatives],
+                        explanation: entry.explanation,
+                        example: entry.example,
+                        source: entry.source,
+                    },
+                }
+                : {}),
+        };
+        const text = found
+            ? `'${word}': ${entry?.alternatives.join(", ")}`
+            : `'${word}'은(는) 사전에 없습니다. 비슷한 낱말: ${related.map((r) => r.word).join(", ") || "없음"}`;
+        return { content: [{ type: "text", text }], structuredContent };
+    });
+}
+//# sourceMappingURL=lookup.js.map

package/dist/tools/lookup.js.map

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

package/dist/tools/validate.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { validate, validationReportSchema } from "../rules/index.js";
+const MAX_CHARS = 50_000;
+const VERDICT_LABEL = {
+    pass: "통과",
+    "needs-review": "검토 필요",
+    fail: "수정 필요",
+};
+const SEVERITY_LABEL = { error: "오류", warning: "경고", info: "참고" };
+/** 리포트를 사람이 읽을 한국어 요약 텍스트로 만든다(content용). */
+function formatReport(report) {
+    const { summary } = report;
+    const lines = [
+        `판정: ${VERDICT_LABEL[report.verdict]} (오류 ${summary.errors} · 경고 ${summary.warnings} · 참고 ${summary.infos})`,
+    ];
+    if (report.violations.length === 0) {
+        lines.push("발견된 문제가 없습니다.");
+    }
+    else {
+        for (const v of report.violations) {
+            const excerpt = v.excerpt !== undefined && v.excerpt !== "" ? ` ("${v.excerpt}")` : "";
+            lines.push(`- [${SEVERITY_LABEL[v.severity]}] ${v.ruleId}: ${v.message}${excerpt}`);
+        }
+        if (summary.truncated === true)
+            lines.push("… 문제가 많아 일부만 표시했습니다.");
+    }
+    lines.push("", ...report.notices);
+    return lines.join("\n");
+}
+/**
+ * validate_easy_read 도구를 서버에 등록한다(FR-01·07·10, 계약: 02 §3.1).
+ * 입력 파싱은 zod가, 규칙 실행·리포트는 rules/가 담당한다(도구는 조립만).
+ */
+export function registerValidateTool(server, dictionary) {
+    server.registerTool("validate_easy_read", {
+        title: "쉬운 정보 검증",
+        description: "한국어 텍스트가 쉬운 정보(Easy-Read) 작성 지침을 지키는지 검사한다. 쉬운 정보 초안을 만들었거나 검토할 때 반드시 호출한다. 원문(original)을 함께 주면 날짜·금액 등 사실 보존까지 검사한다.",
+        inputSchema: {
+            text: z
+                .string()
+                .min(1, { message: "검사할 텍스트를 입력하세요." })
+                .max(MAX_CHARS, {
+                message: "텍스트가 너무 깁니다(최대 50,000자). 나눠서 검사해 주세요.",
+            })
+                .refine((s) => s.trim().length > 0, { message: "빈 텍스트입니다. 검사할 내용을 입력하세요." })
+                .describe("검사할 쉬운 정보 텍스트(1~50,000자). span은 UTF-16 인덱스 기준."),
+            original: z
+                .string()
+                .max(MAX_CHARS)
+                .optional()
+                .describe("원문. 함께 주면 사실 보존(날짜·금액 등, ACC 규칙군)까지 검사한다."),
+            config: z
+                .object({
+                maxWordsWarning: z.number().int().positive().optional().describe("문장 길이 경고 임계값(기본 10)."),
+                maxWordsError: z.number().int().positive().optional().describe("문장 길이 오류 임계값(기본 15)."),
+                excludeRules: z.array(z.string()).optional().describe("끌 규칙 ID 목록(예: [\"SEN-02\"])."),
+            })
+                .optional(),
+        },
+        outputSchema: validationReportSchema.shape,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, ({ text, original, config }) => {
+        try {
+            const report = validate({ raw: text, original, config, dictionary });
+            return {
+                content: [{ type: "text", text: formatReport(report) }],
+                structuredContent: report,
+            };
+        }
+        catch {
+            // 내부 예외: 스택·입력 본문을 응답에 싣지 않는다(NFR-03, 03 §6).
+            return {
+                content: [{ type: "text", text: "서버 내부 오류가 생겼습니다. 잠시 후 다시 시도해 주세요." }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "easyread-mcp",
+  "version": "0.1.0",
+  "description": "복잡한 한국어 텍스트를 쉬운 정보(Easy-Read)로 바꾸는 작업을 돕는 MCP 서버. 검증·분석·사전·지침을 오프라인 결정적 도구로 제공한다.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "easy-read",
+    "accessibility",
+    "korean",
+    "plain-language"
+  ],
+  "license": "MIT",
+  "author": "EASYREAD contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SWJoong/EASYREAD.git"
+  },
+  "homepage": "https://github.com/SWJoong/EASYREAD#readme",
+  "bugs": {
+    "url": "https://github.com/SWJoong/EASYREAD/issues"
+  },
+  "type": "module",
+  "bin": {
+    "easyread-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.20.1",
+    "eslint": "^10.8.1",
+    "tsx": "^4.23.11",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.66.0",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}