readability-mcp-server

MCP 서버로, 어떤 AI 에이전트든 자신이 만든 텍스트가 사람에게 도달하기 전에 그 텍스트의 평이한 언어 품질을 확인하고 개선할 수 있게 해 줍니다. 완전히 로컬에서 동작합니다. API 키도, 네트워크 호출도, 외부 서비스도 필요 없습니다. 순수한 계산 도구이므로 이 서버로 전달하는 어떤 내용도 실행 중인 머신을 벗어나지 않습니다.

이 시리즈의 다른 도구들(scamlens, clearread, clauselens)과 달리, 이것은 사람이 여는 웹사이트가 아니라 AI 에이전트 생태계 자체를 위한 인프라입니다. MCP 호환 클라이언트(Claude Code, Claude Desktop, 또는 그 밖에 어떤 것이든)라면 직접 호출할 수 있습니다.

왜

에이전트는 응답, 문서, 공지, 오류 메시지 등 많은 텍스트를 생성하지만, 대부분은 그 텍스트가 실제로 수신자가 읽기 쉬운지 보내기 전에 확인할 방법이 없습니다. 이 서버는 에이전트가 그 자체 점검을 일급 도구 호출로 수행할 수 있게 해 줍니다. 이미 배포되어 테스트된 동일한 평이한 언어 엔진(문장 분할 + 검증된 복잡어-평이어 사전)을 사용하며, 이 시리즈의 독립형 웹 앱인 clearread에서 이미 검증한 것입니다. 브라우저에 손으로 붙여 넣는 대신 프로그램적으로 호출할 수 있게 노출한 것입니다.

Related MCP server: BeLikeNative Grammar Server

도구

readability_score_text

영어 텍스트 블록에 대한 Flesch Reading Ease 점수와 Flesch-Kincaid Grade Level을 계산합니다. Flesch 공식은 영어 음절 패턴을 가정하므로, 비라틴 문자 텍스트에 대해서는 구조적 수치만 반환하고 supported: false를 돌려줍니다.

readability_simplify_text

텍스트를 더 평이한 언어로 다시 씁니다. 지나치게 긴 문장을 자연스러운 절 경계에서 나누고, 흔한 관청식 어휘를 더 쉬운 표현으로 바꿉니다. 또 다시 쓰기의 편리함을 보여주기 위해 전후의 Flesch Reading Ease 점수를 함께 보고하므로, 재작성이 실제로 도움이 되었는지 확인할 수 있습니다. 의도적으로 영어 전용입니다. 형태론이 비교적 풍부한 언어에서는 단어 치환이 신뢰할 수 없기 때문에, 비라틴 문자 텍스트는 감지되어 그대로 통과되며 문법을 망치지 않습니다. 자세한 이유는 src/services/simplify.ts의 주석을 참고하세요. 예를 들어 "accompanied" → "went with"처럼 유효해 보였던 일부 사전 항목들이 "must be accompanied by" 같은 흔한 고정 표현을 깨뜨린 뒤에 제외된 이유가 설명되어 있습니다.

설치 및 구성

클론하고 빌드합니다:

git clone https://github.com/wedo911/readability-mcp-server.git
cd readability-mcp-server
npm install
npm run build

MCP 클라이언트 설정에 추가합니다(예: Claude Desktop의 claude_desktop_config.json, 또는 Claude Code용 프로젝트의 .mcp.json):

{
  "mcpServers": {
    "readability": {
      "command": "node",
      "args": ["/absolute/path/to/readability-mcp-server/dist/index.js"]
    }
  }
}

테스트 실행

npm run build
node --test tests/textStats.test.mjs tests/simplify.test.mjs

클라이언트 없이 사용해 보기

MCP Inspector는 명령줄에서 직접 도구를 호출할 수 있습니다:

npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call --tool-name readability_simplify_text \
  --tool-arg text="Please utilize the enclosed form prior to the deadline."

라이선스

MIT — LICENSE를 참조하세요.