easyread-mcp 0.1.2 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/assets/dictionary.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
3
|
-
"updatedAt": "2026-08-
|
|
2
|
+
"version": "0.2.0",
|
|
3
|
+
"updatedAt": "2026-08-21",
|
|
4
4
|
"entries": [
|
|
5
5
|
{ "word": "구비서류", "category": "difficult", "alternatives": ["필요한 서류", "준비할 서류"], "example": "필요한 서류를 가져오세요.", "source": "자체 구축(국립국어원 다듬은 말·행정용어 순화 참고)" },
|
|
6
6
|
{ "word": "부득이한", "category": "difficult", "alternatives": ["어쩔 수 없는"], "example": "어쩔 수 없는 이유로 못 왔습니다.", "source": "자체 구축(국립국어원 다듬은 말·행정용어 순화 참고)" },
|
|
@@ -113,6 +113,31 @@
|
|
|
113
113
|
{ "word": "복지부", "category": "abbreviation", "alternatives": ["보건복지부"], "source": "자체 구축" },
|
|
114
114
|
{ "word": "인강", "category": "abbreviation", "alternatives": ["인터넷 강의"], "source": "자체 구축" },
|
|
115
115
|
{ "word": "초중고", "category": "abbreviation", "alternatives": ["초등학교·중학교·고등학교"], "source": "자체 구축" },
|
|
116
|
-
{ "word": "국공립", "category": "abbreviation", "alternatives": ["국립·공립"], "source": "자체 구축" }
|
|
116
|
+
{ "word": "국공립", "category": "abbreviation", "alternatives": ["국립·공립"], "source": "자체 구축" },
|
|
117
|
+
{ "word": "로그인", "category": "loanword", "alternatives": ["들어가기", "접속"], "example": "여기를 눌러 들어가세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
118
|
+
{ "word": "로그아웃", "category": "loanword", "alternatives": ["나가기"], "example": "다 쓰면 나가기를 누르세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
119
|
+
{ "word": "클릭", "category": "loanword", "alternatives": ["누르기"], "example": "그림을 누르세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
120
|
+
{ "word": "버튼", "category": "loanword", "alternatives": ["단추"], "example": "파란 단추를 누르세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
121
|
+
{ "word": "메뉴", "category": "loanword", "alternatives": ["차림표", "기능 목록"], "example": "위쪽 목록에서 고르세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
122
|
+
{ "word": "앱", "category": "loanword", "alternatives": ["프로그램"], "example": "이 프로그램을 여세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
123
|
+
{ "word": "팝업", "category": "loanword", "alternatives": ["뜬 창", "새로 열린 창"], "example": "새로 열린 창을 닫으세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
124
|
+
{ "word": "배너", "category": "loanword", "alternatives": ["띠 광고", "알림 띠"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
125
|
+
{ "word": "스크롤", "category": "loanword", "alternatives": ["화면 내리기", "화면 밀기"], "example": "손가락으로 화면을 내리세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
126
|
+
{ "word": "아이콘", "category": "loanword", "alternatives": ["그림 단추", "그림"], "example": "그림 단추를 누르세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
127
|
+
{ "word": "로딩", "category": "loanword", "alternatives": ["불러오는 중", "기다리는 중"], "example": "잠깐 기다리세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
128
|
+
{ "word": "이메일", "category": "loanword", "alternatives": ["전자우편", "누리편지"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
129
|
+
{ "word": "아이디", "category": "loanword", "alternatives": ["사용자 이름", "로그인 이름"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
130
|
+
{ "word": "홈", "category": "loanword", "alternatives": ["첫 화면", "시작 화면"], "example": "첫 화면으로 돌아가세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
131
|
+
{ "word": "카테고리", "category": "loanword", "alternatives": ["분류", "갈래"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
132
|
+
{ "word": "업데이트", "category": "loanword", "alternatives": ["새로 바꾸기", "최신으로 바꾸기"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
133
|
+
{ "word": "인증", "category": "difficult", "alternatives": ["본인 확인"], "example": "본인 확인을 해 주세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
134
|
+
{ "word": "계정", "category": "difficult", "alternatives": ["내 정보", "사용자 정보"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
135
|
+
{ "word": "회원가입", "category": "difficult", "alternatives": ["가입", "가입하기"], "example": "먼저 가입을 하세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
136
|
+
{ "word": "첨부", "category": "difficult", "alternatives": ["붙임", "붙인 파일"], "example": "파일을 붙이세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
137
|
+
{ "word": "접속", "category": "difficult", "alternatives": ["들어가기", "연결"], "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
138
|
+
{ "word": "검색", "category": "difficult", "alternatives": ["찾기"], "example": "여기서 찾으세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
139
|
+
{ "word": "암호", "category": "difficult", "alternatives": ["비밀번호"], "example": "비밀번호를 넣으세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
140
|
+
{ "word": "오류", "category": "difficult", "alternatives": ["잘못됨", "문제"], "example": "문제가 생겼습니다.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" },
|
|
141
|
+
{ "word": "새로고침", "category": "terminology", "alternatives": ["다시 불러오기"], "explanation": "화면의 내용을 최신 상태로 다시 불러오는 것.", "example": "화면을 다시 불러오세요.", "source": "자체 구축(국립국어원 다듬은 말·정보통신 용어 순화 참고)" }
|
|
117
142
|
]
|
|
118
143
|
}
|
package/dist/data/guidelines.js
CHANGED
|
@@ -34,6 +34,17 @@ export const GUIDELINES_MARKDOWN = `# 쉬운 정보(Easy-Read) 작성 지침
|
|
|
34
34
|
- 변환 절차를 따르고, 결과물은 당사자 감수 전 초안임을 밝힙니다.
|
|
35
35
|
- 발달장애인 당사자의 확인·감수를 거쳐 최종본을 확정합니다.
|
|
36
36
|
|
|
37
|
+
## 웹·디지털에 담기 (참고 — 규칙 아님)
|
|
38
|
+
쉬운 정보를 웹·앱 화면에 담을 때의 참고 안내입니다. 문장·어휘 검사(위 규칙)로 문구를 다듬은 뒤, 아래는 사람이 함께 살핍니다.
|
|
39
|
+
- **한 화면에 한 가지**: 한 화면·한 문단에 한 가지 정보만 담습니다. 길면 여러 화면·단계로 나눕니다.
|
|
40
|
+
- **찾기 쉽게**: 지금 어디인지(제목)와 무엇을 누르면 어디로 가는지 분명히 합니다. 메뉴·단추 이름은 짧고 하는 일 그대로 씁니다(예: '다음', '저장', '가입하기').
|
|
41
|
+
- **UI 문구도 쉬운 말로**: 버튼·설명·오류 안내도 쉬운 낱말과 짧은 완결문으로 씁니다. lookup_easy_word로 UI 낱말(로그인·인증·팝업 등)의 쉬운 대체어를 찾을 수 있습니다.
|
|
42
|
+
- **글과 그림을 함께**: 중요한 안내는 글과 그림·기호를 함께 보여 줍니다(그림 자체는 이 도구의 검사 밖 — 사람이 확인합니다).
|
|
43
|
+
- **PDF보다 웹(HTML)**: 글자가 화면 크기에 맞춰 커지고 읽어 주기(스크린리더)도 잘 되도록, 가능하면 PDF보다 웹 문서로 올립니다.
|
|
44
|
+
- **당사자 사용성 확인**: 최종본은 발달장애인 당사자가 실제 화면에서 찾고·읽고·해낼 수 있는지 확인·감수합니다.
|
|
45
|
+
|
|
46
|
+
근거·표준은 리소스 easyread://resources 의 웹·디지털 항목(W3C COGA, 각국 정부의 쉬운 언어·접근성 지침)을 참고하세요.
|
|
47
|
+
|
|
37
48
|
## 효율적으로 바꾸기 (도구 활용·속도·토큰 절약)
|
|
38
49
|
- **필요한 부분만 넣기**: 긴 원문·웹페이지는 전체를 넣지 말고 꼭 필요한 부분(제목·자격·근무조건·기한·연락처)만 골라 넣습니다. 검사 한도는 5만 자이며, 길면 토막으로 나눠 바꿉니다.
|
|
39
50
|
- **먼저 분석, 나중에 검증**: analyze_readability로 가장 긴 문장·어려운 낱말을 먼저 찾아 그 부분부터 고칩니다. 다 고친 뒤 validate_easy_read로 한 번에 검사하면 왕복이 줍니다.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guidelines.js","sourceRoot":"","sources":["../../src/data/guidelines.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG
|
|
1
|
+
{"version":3,"file":"guidelines.js","sourceRoot":"","sources":["../../src/data/guidelines.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDlC,CAAC;AAEF,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,KAAK;CACX,CAAC;AACF,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAsB;IAC3D,MAAM,KAAK,GAAG,CAAC,eAAe,EAAE,EAAE,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,KAAK,GAAG,CAAC,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
|
package/dist/server.js
CHANGED
|
@@ -12,7 +12,7 @@ import { normalizeToolSchemaDialect } from "./schema-dialect.js";
|
|
|
12
12
|
* EASYREAD MCP 서버를 조립한다. 도구·프롬프트·리소스 등록만 담당하고 로직은 갖지 않는다(03 §1).
|
|
13
13
|
*/
|
|
14
14
|
export function createServer(dictionary, catalog) {
|
|
15
|
-
const server = new McpServer({ name: "easyread", version: "0.1.
|
|
15
|
+
const server = new McpServer({ name: "easyread", version: "0.1.3" });
|
|
16
16
|
// SDK가 도구 스키마를 draft-07로 방출 → 최신 클라이언트(2020-12) 호환되게 정규화.
|
|
17
17
|
// 반드시 도구 등록 전에 호출한다(tools/list 핸들러 설치 시점을 가로채기 위함).
|
|
18
18
|
normalizeToolSchemaDialect(server);
|
package/dist/tools/guidelines.js
CHANGED
|
@@ -17,7 +17,7 @@ const SECTION_CONTENT = {
|
|
|
17
17
|
숫자: "# 숫자 (NUM)\n\n- 숫자는 아라비아 숫자로, 큰 수는 만/억 단위로 끊어 씁니다.\n- 상대적 날짜(‘익일’) 대신 정확한 날짜를 씁니다.",
|
|
18
18
|
구성: "# 구성 (STR)\n\n- 한 단락에 한 주제만 담고, 문장이 많으면 나눕니다.\n- 여러 항목 나열은 글머리표 목록으로 만듭니다.",
|
|
19
19
|
표기: "# 표기 (TYP)\n\n- 기호(※, ~, &, /)는 말로 풀어 씁니다.\n- 괄호·쌍점(:)·쌍반점(;)을 절제합니다.",
|
|
20
|
-
절차: "# 절차 (PROC)\n\n- 당사자(발달장애인)가 직접 확인·감수하도록 합니다. 자동 검사가 아닌 점검
|
|
20
|
+
절차: "# 절차 (PROC)\n\n- 당사자(발달장애인)가 직접 확인·감수하도록 합니다. 자동 검사가 아닌 점검 항목입니다.\n- 그림·사진 병기 등 시각 자료를 함께 검토합니다.\n- 웹·앱 화면에 담을 때는 한 화면에 한 가지 정보, 쉬운 UI 문구, 찾기 쉬운 구성을 함께 살핍니다(easyread://guidelines의 ‘웹·디지털에 담기’ 참고).",
|
|
21
21
|
정확성: "# 정확성 (ACC)\n\n- 원문의 날짜·금액·기관명·연락처를 바꾸거나 빠뜨리지 않습니다.\n- 쉽게 바꾸더라도 사실은 그대로 유지합니다.",
|
|
22
22
|
};
|
|
23
23
|
function ruleIdsFor(section) {
|
|
@@ -1 +1 @@
|
|
|
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,
|
|
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,EACA,sMAAsM;IACxM,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"}
|