使用说明
项目简介
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 服务器提供的功能。
使用示例:
-
统计文本字符数: 在聊天框中输入类似指令:
请帮我统计这段文字的字符数: [这里粘贴你的文本]或者
请分析一下这个文件 [上传文件,如 .txt 或 .md] 的字符数。客户端会自动调用 'count-text-chars' 工具,并将文本内容或文件路径作为参数传递给 MCP 服务器,服务器会返回字符数统计结果。
-
统计日语单词数: 输入类似指令:
请帮我统计这段日语文本的单词数: [这里粘贴你的日语文本]或者
请分析文件 [文件路径或上传文件] 的日语单词数。客户端可能会根据上下文或提示让您选择语言,或者您可以在指令中明确指定语言 (如果客户端支持工具参数配置)。服务器会根据语言设置调用 '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与计算