使用说明

项目简介

Word Counter MCP服务器是一个实现了 Model Context Protocol (MCP) 的后端应用，专注于文本分析功能。它提供了一个名为 'analyze_text' 的工具，使大型语言模型 (LLM) 能够安全地分析本地文本文件，获取字数和字符数等统计数据，而无需将文件内容直接发送到 LLM，保护了数据隐私。

主要功能点

字数统计: 统计文本文件中的单词数量。
字符数统计 (包含空格): 统计文本文件中包含空格的所有字符数量。
字符数统计 (不包含空格): 统计文本文件中不包含空格的字符数量。
本地文件处理: 直接处理本地文件，无需将文件内容上传或暴露给 LLM 客户端。
MCP 协议支持: 遵循 MCP 协议标准，易于集成到支持 MCP 协议的 LLM 客户端，如 Claude Desktop。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node.js 包管理器)。你可以从 https://nodejs.org/ 下载并安装。
安装 mcp-wordcounter: 打开终端或命令提示符，运行以下命令安装 'mcp-wordcounter' 包：
```
npm install mcp-wordcounter
```

服务器配置

对于支持 MCP 服务器配置的 LLM 客户端 (例如 Claude Desktop)，你需要添加以下配置信息以连接到 Word Counter MCP 服务器。以下配置描述了如何让 Claude Desktop 客户端知道如何启动和连接到 'mcp-wordcounter' 服务器。

在 Claude Desktop 的配置文件 ('claude_desktop_config.json') 中，添加或修改 'mcpServers' 部分，加入以下 JSON 配置：

{
  "mcpServers": {
    "mcp-wordcounter": {
      "command": "npx",
      "args": ["-y", "mcp-wordcounter"],
      "alwaysAllow": ["analyze_text"]
    }
  }
}

配置参数说明:

'"mcp-wordcounter"': 服务器名称，用于在客户端中标识和引用该服务器。可以自定义。
'"command": "npx"': 启动服务器的命令。'npx' 是 npm 包执行器，用于运行本地安装的 npm 包的可执行文件。
'"args": ["-y", "mcp-wordcounter"]': 传递给 'npx' 命令的参数。
- '"-y"': (可选) 'npx' 的参数，此处 '-y' 可能是为了自动确认一些提示，具体作用可能需要查看 'npx' 文档。在大多数情况下可以省略。
- '"mcp-wordcounter"': 要执行的 npm 包的可执行文件名，对应于 'mcp-wordcounter' 包提供的命令行入口。
'"alwaysAllow": ["analyze_text"]': (可选) 配置 Claude Desktop 客户端始终允许该 MCP 服务器调用的工具列表。 '"analyze_text"' 是 Word Counter 服务器提供的工具名称。

基本使用方法

配置完成后，当你在 Claude Desktop 中与 LLM 对话时，可以指示 LLM 使用 'analyze_text' 工具来分析文本文件。例如，你可以这样指示 LLM：

"请分析一下 '文件路径/到/你的/文本文件.txt' 这个文件，告诉我它的字数和字符数统计。"

LLM 客户端 (如 Claude Desktop) 会根据你的指示，调用 Word Counter MCP 服务器的 'analyze_text' 工具，并将文件路径作为参数传递给服务器。服务器会读取指定文件，进行分析，并将分析结果返回给 LLM 客户端，最终呈现给你。

工具调用示例 (通过 LLM 指示):

analyze_text filePath="文件路径/到/你的/文本文件.txt"

工具返回结果示例 (JSON 格式，客户端通常会解析并展示为更友好的格式):

{
  "content": [{
    "type": "text",
    "text": "Analysis Results:\n• Word count: 150\n• Character count (including spaces): 842\n• Character count (excluding spaces): 702"
  }]
}

通过 Word Counter MCP 服务器，LLM 可以安全高效地利用文本分析功能，扩展其处理文档的能力。

关键词