使用说明

项目简介

Japanese Text Analyzer MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器,旨在为 LLM 客户端提供日语和英语文本的分析能力。目前主要提供文本的字符数和单词数统计功能。它通过工具 (Tools) 的形式暴露功能,客户端可以调用这些工具来分析文本内容。

主要功能点

  • 字符数统计: 能够统计文本(包括文件或直接输入的文本)中的字符数,并排除空格和换行符,提供有效字符数。
  • 单词数统计:
    • 英语: 通过空格分隔单词进行统计。
    • 日语: 使用形态素分析库 kuromoji.js 进行分词,更准确地统计日语单词数量(包括助词、助动词等)。
  • 文件和文本输入: 支持直接输入文本或指定文件路径作为分析内容。
  • MCP 服务器: 遵循 MCP 协议,易于与支持 MCP 协议的 LLM 客户端集成,例如 Claude for Desktop 和 Cursor。

安装步骤

由于该 MCP 服务器以 npm 包的形式发布在 GitHub 仓库,最简便的使用方式是通过 'npx' 直接运行,无需本地安装:

npx -y github:Mistizz/mcp-JapaneseTextAnalyzer

首次运行会自动下载并执行,后续运行速度会更快。

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Claude for Desktop 或 Cursor)连接,您需要在客户端的配置文件中添加服务器配置信息。以下是通用的配置方法,以及针对不同环境的建议配置。

通用配置 (大多数环境适用)

{
  "mcpServers": {
    "JapaneseTextAnalyzer": {  // 服务器名称,可以自定义
      "command": "npx",      // 启动命令,通常为 npx
      "args": [             // 启动参数
        "-y",               // npx 参数,自动确认安装包
        "github:Mistizz/mcp-JapaneseTextAnalyzer" // GitHub 仓库地址,指定要运行的 MCP 服务器
      ]
    }
  }
}

Windows 环境配置 (如果通用配置无效)

如果通用配置在 Windows 环境下无法正常启动,可以尝试使用 'cmd /c' 来执行 'npx' 命令:

{
  "mcpServers": {
    "JapaneseTextAnalyzer": {
      "command": "cmd",      // Windows 命令提示符
      "args": [             // 启动参数
        "/c",               // cmd 参数,执行后续命令后终止
        "npx",              // 启动命令,npx
        "-y",               // npx 参数,自动确认安装包
        "github:Mistizz/mcp-JapaneseTextAnalyzer"  // GitHub 仓库地址,指定要运行的 MCP 服务器
      ]
    }
  }
}

配置位置:

  • Claude for Desktop: 编辑 'claude_desktop_config.json' 文件,通常位于用户配置目录下。
  • Cursor: 编辑 '.cursor' 文件夹下的 'mcp.json' 文件。

将上述 JSON 配置添加到 'mcpServers' 字段中,保存配置文件后,MCP 客户端应该能够检测到并连接到 JapaneseTextAnalyzer MCP 服务器。

基本使用方法

配置完成后,在支持 MCP 客户端的应用中 (如 Claude for Desktop, Cursor),您可以像与普通工具交互一样使用该 MCP 服务器提供的功能。

使用示例:

  1. 统计文本字符数: 在聊天框中输入类似指令:

    请帮我统计这段文字的字符数:  [这里粘贴你的文本]

    或者

    请分析一下这个文件 [上传文件,如 .txt 或 .md] 的字符数。

    客户端会自动调用 'count-text-chars' 工具,并将文本内容或文件路径作为参数传递给 MCP 服务器,服务器会返回字符数统计结果。

  2. 统计日语单词数: 输入类似指令:

    请帮我统计这段日语文本的单词数: [这里粘贴你的日语文本]

    或者

    请分析文件 [文件路径或上传文件] 的日语单词数。

    客户端可能会根据上下文或提示让您选择语言,或者您可以在指令中明确指定语言 (如果客户端支持工具参数配置)。服务器会根据语言设置调用 'count-text-words' 工具,并使用相应的分词方法进行统计。

工具列表:

该 MCP 服务器提供以下工具 (Tools):

  • 'count-text-chars': 统计文本字符数 (推荐使用)。
  • 'count-text-words': 统计文本单词数 (推荐使用)。
  • 'count-chars' (已弃用): 统计文件字符数,建议使用 'count-text-chars' 替代。
  • 'count-words' (已弃用): 统计文件单词数,建议使用 'count-text-words' 替代。
  • 'count-clipboard-chars' (已弃用): 统计剪贴板文本字符数,建议使用 'count-text-chars' 替代。
  • 'count-clipboard-words' (已弃用): 统计剪贴板文本单词数,建议使用 'count-text-words' 替代。

请优先使用 'count-text-chars' 和 'count-text-words' 这两个更通用的工具。

信息

分类

AI与计算