Japanese Text Analyzer MCP Server

Japanese Text Analyzer 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：英语，ja：日语）

输出：

• 文件的单词数
• 日语模式下还会显示形态素分析的详细结果

count_clipboard_chars

统计文本的字符数。统计不包括空格和换行符的有效字符数。

输入：

• text (string)：要统计字符数的文本

输出：

• 文本的字符数（不包括空格和换行符的有效字符数）

count_clipboard_words

统计文本的单词数。英语按空格分隔的单词进行统计，日语则使用形态素分析。

输入：

• text (string)：要统计单词数的文本
• language (string，可选，默认值："en")：文本的语言（en：英语，ja：日语）

输出：

• 文本的单词数
• 日语模式下还会显示形态素分析的详细结果

analyze_text

对文本进行详细的形态素分析和语言特征分析。分析句子复杂度、词性比例、词汇多样性等。

输入：

• text (string)：要分析的文本

输出：

• 文本的基本信息（总字符数、句子数、形态素总数）
• 详细分析结果（平均句长、词性比例、字符类型比例、词汇多样性等）

analyze_file

对文件进行详细的形态素分析和语言特征分析。分析句子复杂度、词性比例、词汇多样性等。

输入：

• filePath (string)：要分析的文件路径（建议使用 Windows 格式或 WSL/Linux 格式的绝对路径）

输出：

• 文件的基本信息（总字符数、句子数、形态素总数）
• 详细分析结果（平均句长、词性比例、字符类型比例、词汇多样性等）

使用方法

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Japanese Text Analyzer：

npx -y @smithery/cli install @Mistizz/mcp-JapaneseTextAnalyzer --client claude

使用 npx 运行

此软件包可通过 npx 直接从 GitHub 仓库运行：

npx -y github:Mistizz/mcp-JapaneseTextAnalyzer

在 Claude for Desktop 中使用

请将以下内容添加到 Claude for Desktop 的配置文件中：

Windows： %AppData%\Claude\claude_desktop_config.json

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

{
  "mcpServers": {
    "JapaneseTextAnalyzer": {
      "command": "npx",
      "args": [
        "-y",
        "github:Mistizz/mcp-JapaneseTextAnalyzer"
      ]
    }
  }
}

在 Cursor 中使用

在 Cursor 中也需要将相同的配置添加到.cursor文件夹中的mcp.json文件。

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

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

通用配置（适用于大多数环境）：

{
  "mcpServers": {
    "JapaneseTextAnalyzer": {
      "command": "npx",
      "args": [
        "-y",
        "github:Mistizz/mcp-JapaneseTextAnalyzer"
      ]
    }
  }
}

如果上述配置在 Windows 环境中无法运行，请尝试以下配置：

{
  "mcpServers": {
    "JapaneseTextAnalyzer": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "github:Mistizz/mcp-JapaneseTextAnalyzer"
      ]
    }
  }
}

使用示例

直接统计文本的字符数

このテキストの文字数を数えてください。

使用日语模式统计文件的单词数

C:\path\to\your\file.txt の単語数を日本語モードで数えてください。

使用 WSL/Linux 格式的路径统计单词数

/c/Users/username/Documents/file.txt の単語数を日本語モードで数えてください。

仅使用文件名统计单词数

README.md の単語数を英語モードで数えてください。

粘贴文本并统计日语单词数

次のテキストの日本語の単語数を数えてください：

吾輩は猫である。名前はまだ無い。どこで生れたかとんと見当がつかぬ。何でも薄暗いじめじめした所でニャーニャー泣いていた事だけは記憶している。

分析文本的详细语言特征

次のテキストを詳細に分析してください：

私は昨日、新しい本を買いました。とても面白そうな小説で、友人からの評判も良かったです。今週末にゆっくり読む予定です。

分析文件的详细语言特征

C:\path\to\your\file.txt を詳細に分析してください。

文件路径解析功能

指定文件路径后，此工具会灵活地搜索文件：

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ファイルをご覧ください。