일본어 텍스트 분석기 MCP 서버

일본어 텍스트의 형태소 해석을 실시할 수 있는 MCP 서버입니다. 문장의 특징을 언어학적 관점에서 측정·평가하여 문장 생성 피드백에 도움이 됩니다.

기능

• 일본어 텍스트의 문자수(공백이나 개행을 제외한 실질적인 문자수)를 카운트
• 일본어 텍스트의 단어 수 계산
• 일본어 텍스트의 상세한 언어적 특징 분석(평균 문장, 품사 비율, 어휘 다양성 등)
• 파일 경로 또는 직접 텍스트 입력 모두 지원
• 유연한 파일 경로 해결(절대 경로, 상대 경로, 파일 이름만으로도 검색 가능)

도구

현재 다음과 같은 도구가 구현되었습니다.

count_chars

파일의 문자 수를 측정합니다. 절대 경로를 지정하십시오(Windows 형식 C:\Users... 또는 WSL/Linux 형식 /c/Users/... 둘 다 가능). 공백이나 줄 바꿈을 제외한 실제 문자 수를 계산합니다.

입력:

• filePath (string) : 문자 수를 계산하는 파일 경로 (Windows 형식 또는 WSL / Linux 형식의 절대 경로 권장)

산출:

• 파일의 문자 수(공백이나 개행을 제외한 실제 문자 수)

count_words

파일의 단어 수를 측정합니다. 절대 경로를 지정하십시오(Windows 형식 C:\Users... 또는 WSL/Linux 형식 /c/Users/... 둘 다 가능). 영어에서는 공백으로 구분 된 단어를 계산하고 일본어에서는 형태소 분석을 사용합니다.

입력:

• filePath (string) : 단어 수를 계산하는 파일 경로 (Windows 형식 또는 WSL / Linux 형식의 절대 경로 권장)
• language (string, 옵션, 기본값: "en"): 파일 언어 (en: language , ko: 한국어)

산출:

• 파일의 단어 수
• 일본어 모드의 경우 형태소 해석의 상세 결과도 표시

count_clipboard_chars

텍스트의 문자 수를 측정합니다. 공백이나 줄 바꿈을 제외한 실제 문자 수를 계산합니다.

입력:

• text (string): 문자 수를 계산하는 텍스트

산출:

• 텍스트의 문자 수 (공백이나 줄 바꿈을 제외한 실제 문자 수)

count_clipboard_words

텍스트의 단어 수를 측정합니다. 영어에서는 공백으로 구분 된 단어를 계산하고 일본어에서는 형태소 분석을 사용합니다.

입력:

• text (string): 단어 수를 계산하는 텍스트
• language (string, 옵션, 기본값: "en"): 텍스트 언어 (en: language , ko: 한국어)

산출:

• 텍스트 단어 수
• 일본어 모드의 경우 형태소 해석의 상세 결과도 표시

analyze_text

텍스트의 상세한 형태소 해석과 언어적 특징의 분석을 실시합니다. 문장의 복잡성, 품사의 비율, 어휘의 다양성 등을 분석합니다.

입력:

• text (string): 분석할 텍스트

산출:

• 텍스트의 기본 정보(총문자수, 문장수, 총형태소수)
• 상세 분석 결과(평균 문장, 품사의 비율, 문자종의 비율, 어휘의 다양성 등)

analyze_file

파일의 상세한 형태소 해석과 언어적 특징의 해석을 실시합니다. 문장의 복잡성, 품사의 비율, 어휘의 다양성 등을 분석합니다.

입력:

• filePath (string): 분석할 파일의 경로(Windows 형식 또는 WSL/Linux 형식의 절대 경로 권장)

산출:

• 파일의 기본 정보(총문자수, 문장수, 총형태소수)
• 상세 분석 결과(평균 문장, 품사의 비율, 문자종의 비율, 어휘의 다양성 등)

사용방법

npx에서 실행

이 패키지는 npx에서 GitHub 리포지토리에서 직접 실행할 수 있습니다.

Claude for Desktop에서 사용

Claude for Desktop 구성 파일에 다음을 추가하십시오.

Windows: %AppData%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

커서에서 사용

Cursor에서도 비슷한 설정을 .cursor 폴더의 mcp.json 파일에 추가합니다.

Windows: %USERPROFILE%\.cursor\mcp.json

macOS/Linux: ~/.cursor/mcp.json

일반 설정 (일반 환경에서 작동) :

Windows 환경에서 위에서 작동하지 않으면 다음을 시도해보십시오.

사용 예

직접 텍스트의 문자 수 계산

파일의 단어 수를 일본어 모드로 계산

WSL / Linux 형식의 경로로 단어 수를 계산합니다.

파일 이름만으로 단어 수를 계산합니다.

텍스트를 붙여 넣어 일본어 단어 수를 계산

텍스트의 상세한 언어적 특성 분석

파일의 상세한 언어적 특성 분석

파일 경로 해결 기능

이 도구는 파일 경로가 지정된 경우 유연하게 파일을 탐색합니다.

1. 절대 패스가 지정되었을 경우는 그대로 사용
   • Windows 형식의 절대 경로(예: C:\Users\username\Documents\file.txt )
   • WSL / Linux 형식의 절대 경로 (예 : /c/Users/username/Documents/file.txt ) 모두 자동으로 감지 및 변환
2. 현재 디렉토리(작업 디렉토리)를 기준으로 상대 경로 해결
3. 홈 디렉토리( %USERPROFILE% 또는 $HOME )를 기준으로 검색
4. 데스크톱 디렉토리를 기준으로 검색
5. 문서 디렉토리를 기준으로 검색

이렇게 하면 단순히 ``README.md''와 같은 파일 이름만 지정해도 여러 일반 디렉터리에서 자동으로 검색하고 파일이 발견되면 이를 사용합니다. 또한 WSL 환경이나 Git Bash 등에서 얻은 경로( /c/Users/... 형식)도 Windows 환경에서 그대로 사용할 수 있습니다.

내부 동작 정보

이 도구는 일본어 단어 수를 계산하기 위해 "kuromoji.js"라는 형태소 분석 라이브러리를 사용합니다. 형태소 해석은 자연 언어 처리의 기본적인 처리로, 문장을 의미를 가지는 최소 단위(형태소)로 분할합니다.

형태소 해석의 처리는 초기화에 시간이 걸릴 수 있습니다. 특히 사전 데이터를 읽어야 하기 때문에 처음 실행할 때 약간 시간이 걸릴 수 있습니다. 서버 기동시에 형태소 해석기의 초기화를 실시하는 것으로, 툴 실행시의 지연을 최소한으로 억제하고 있습니다.

언어적 특징 분석

'analyze_text'와 'analyze_file' 도구는 형태소 분석 결과를 기반으로 텍스트의 다양한 언어적 특성을 계산합니다. 여기에는 다음과 같은 지표가 포함됩니다.

• 평균 문장 : 문장당 평균 문자 수입니다. 이 값이 클수록 읽기 어려운 문장일 수 있습니다.
• 문당 형태 소수 : 문장당 평균 형태 소수. 문의 밀도와 구문의 복잡성을 나타냅니다.
• 품사의 비율 : 명사, 동사, 형용사 등의 품사가 텍스트에서 어떤 비율로 사용되고 있는지를 나타냅니다.
• 조사 비율 : 특정 조사가 어떤 빈도로 사용되는지 보여주며 문장의 구조와 흐름을 분석합니다.
• 문자 종류의 비율 : 히라가나, 가타카나, 한자, 영숫자의 구성 비율을 나타냅니다.
• 어휘 다양성 : 다른 단어 수와 총 단어 수의 비율(유형/토큰 비율)을 표시하고 어휘의 풍부함을 측정합니다.
• 가타카나어의 비율 : 가타카나어의 사용 빈도를 나타내며 외래어나 전문 용어의 많음, 문체의 캐주얼함을 반영합니다.
• 존경의 빈도 : 존경 표현의 사용 빈도를 표시하고 문장의 정중성과 공식도를 측정합니다.
• 구두점의 평균 수 : 문장 당 구두점의 평균 수를 표시하고 문장 구분 및 가독성에 대한 지표를 제공합니다.

이러한 지표를 결합하여 텍스트의 특성을 다각적으로 분석하고 문체, 가독성, 전문성 등을 평가할 수 있습니다.

라이센스

이 MCP 서버는 MIT 라이센스하에 제공됩니다. 이는 MIT 라이센스의 조건에 따라 소프트웨어를 자유롭게 사용, 변경 및 배포할 수 있음을 의미합니다. 자세한 내용은 프로젝트 리포지토리의 LICENSE 파일을 참조하세요.