essay-stats-mcp

Essay Stats MCP：论文字数统计与写作检查器

你即将提交论文，却不确定是否超出字数限制，也不知道有多少页。聊天助手往往会猜测字数。这个服务会在你的电脑上准确统计字数，让助手给出真实的数字。

只需一行命令，即可在 Claude Code 中安装：

claude mcp add essay-stats -- npx -y essay-stats-mcp

然后可以询问：

• “我的字数上限是 1500，不包括参考文献和引文。我超了吗？”
• “这篇论文使用 Arial 11 磅、1.5 倍行距时有多少页？”
• “找出草稿中的被动语态和填充词。”

Essay Stats MCP 是一款可离线运行的论文字数统计与写作检查工具。它会统计字数和页数，提供可读性评分，并标记被动语态、填充词、长句和重复的句首用语。它还会估算阅读时间。

无需账户、API 密钥，也不会发起网络请求。你的论文文本不会离开你的设备。

快速开始

Claude Code 用户可以使用上面的一行命令。对于其他应用，请复制适用于你客户端的代码片段。需要 Node.js 20 或更高版本。

Claude Desktop

打开 Settings、Developer、Edit Config，将以下内容添加到 claude_desktop_config.json，然后重启 Claude Desktop。

{
  "mcpServers": {
    "essay-stats": {
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

Cursor

将以下内容添加到项目中的 .cursor/mcp.json，或添加到 ~/.cursor/mcp.json 以供所有项目使用。

{
  "mcpServers": {
    "essay-stats": {
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

VS Code

将以下内容添加到工作区中的 .vscode/mcp.json。VS Code 使用 servers 键，而不是 mcpServers。

{
  "servers": {
    "essay-stats": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中使用与 Claude Desktop 相同的代码片段。

工具

工具	功能
count_text	统计字数、字符数、句子数、段落数和阅读时间，并根据字体、字号和行距估算页数。
readability_scores	提供 Flesch Kincaid 年级、Flesch 阅读易读度、Gunning Fog 和 SMOG 评分。
style_flags	标记被动语态、重复的句首用语、填充词和长句。
sentence_variety	分析句长变化，统计短句、中句和长句的数量，以及句长相近的连续句子。
check_word_limit	将文本与字数限制进行比较。可选设置最低字数和容差，也可排除参考文献和引文。
word_frequency	列出出现频率最高的词语及其次数和占比，以便发现过度使用的词语。

这六种工具只会读取你提供的文本。每种工具都会返回简短的文字说明，以及相同的结构化字段数据。

count_text

输入：text，以及可选的 font（times new roman、arial、calibri、georgia、courier new 或 verdana）、以磅为单位的 font_size（默认值为 12）和 spacing（single、1.5 或 double，默认值为 double）。页数根据每页典型字数估算，因此 Word 或 Google Docs 的结果可能略有不同。

readability_scores

输入：text。年级大致对应美国学校年级，因此 12 代表高中毕业年级。SMOG 适用于 30 个或更多句子的文本，所以短文本的结果会标记为可靠性较低。

style_flags

输入：text，以及可选的 max_sentence_words（默认值为 30）。检查采用简单的模式规则。请将结果用作重新阅读句子的提示，而不要视为错误的确凿证据。

句子编号从 1 开始，按文本顺序排列。sentence_list 字段会列出每个被动语态句子或长句及其编号，文本摘要的末尾也会列出这些编号，便于回复指出相应的句子。

sentence_variety

输入：text。返回最短、最长和平均句长（以词数计）、标准差，以及短句（少于 10 个词）、中句（10 到 24 个词）和长句（25 个或更多词）的数量。它还会列出连续 3 个或更多句子组成的句组，其中每句长度与该句组第一句相差不超过 3 个词，并标出这些句子的编号。句子编号从 1 开始，按文本顺序排列。

word_frequency

输入：text，以及可选的 top（列出多少个词，默认为 10）、min_count（列出某个词所需的最少出现次数，默认为 2）和 include_common_words（是否也统计 the、and、of 和 to 等短词，默认为 false）。不区分大小写；除非 include_common_words 为 true，否则会跳过少于 3 个字母的词。

check_word_limit

输入：text、limit，以及可选的 minimum、tolerance_percent、exclude_references 和 exclude_quotes。从 References、Works Cited 或 Bibliography 等标题所在行开始，直至文末的内容会被排除。以 > 开头的行和双引号内的文本会被视为引文。

常见问题：如何统计词数和页数

如何统计词数？

它会按空格和换行拆分文本，并统计其中至少包含一个字母或数字的每一部分。这与 Word 和 Google Docs 的统计方式相同。用连字符连接的词，例如 well-known，写有连字符时算作一个词；像 2024 这样的数字也算作一个词。

为什么我的词数与 Word 不同？

主要是因为粘贴的内容不同。单独出现在空格之间的破折号或符号会被 Word 计入，但这里不会，因为它们不含字母或数字。只有在粘贴进来的情况下，脚注、页眉、页脚和文本框中的内容才会计入。如果两个数字相差几个词，请先检查这些内容。

页数是如何计算的？

count_text 会用词数除以所选字体对应的固定每页词数，然后根据字号和行距进行调整。这只是估算，并非实际排版结果。它无法识别你的页边距、标题、封面页、表格或图片，因此 Word 显示的页数可能不同。若有严格的页数要求，请以你自己的文档中的页数为准。

check_word_limit 会排除哪些内容？

除非你提出要求，否则不会排除任何内容。设置 exclude_references 后，会排除从 References、Works Cited 或 Bibliography 等标题所在行开始直至文末的所有内容。设置 exclude_quotes 后，会排除以 > 开头的行和双引号内的文本。结果会显示总数、计入的词数以及排除的词数，方便你核对老师的统计方式。

容差会改变词数吗？

不会。词数保持不变。tolerance_percent 只会放宽允许的上限，因此，限额为 1500 且容差为 10 percent 时，最多允许 1650 个词。若你超过限额但仍在容差范围内，结果会明确说明。

示例提示词

• "统计这篇论文的词数，并告诉我按 Arial 11 point 字号、1.5 倍行距排版时有多少页。"
• "这篇论文的阅读难度如何？请给出 Flesch Kincaid、Gunning Fog 和 SMOG 分数。"
• "找出我草稿中的被动语态和填充词。"
• "我的限额是 1500 个词，不包括参考文献或引文。我超出了吗？"
• "哪些句子超过了 25 个词？"
• "我的句子听起来是不是长度都一样？"
• "这篇论文中哪些词用得太多？"

对比

Essay Stats MCP 只做一件事：衡量你提供的一段文字。该领域的其他工具用途各不相同，因此下表介绍的是各类工具的用途，而非比较哪种更好。

	Essay Stats MCP	Brightspace MCP 服务，例如 brightspace-mcp-server	在线语法和写作检查工具	让聊天助手计数
主要用途	统计文章的字数、估算页数，并标记可读性和风格问题	从 Brightspace 读取课程数据，例如课程和作业	修正语法、拼写和语气	回答一般问题
可处理你自己的草稿文本	是	否，它处理的是课程数据	是	是
精确统计字数和页数	是，由代码计数	并非其用途	通常只统计字数	往往是估算
检查字数上限时排除参考文献和引文	是，使用 check_word_limit	否	很少支持	不可靠
需要账户或 API 密钥	否	取决于服务，请查看其 README	通常需要账户	取决于应用
会通过网络发送你的文本	否	取决于服务	通常会	会，发送给助手
作为本地 MCP 服务运行	是	是	通常不会	不适用

Essay Stats MCP 不会修改你的文字，也不会访问 Brightspace。如需同时查看 Brightspace 数据，请参阅下一节，了解我们自己的服务 brightspace-d2l-mcp。

配合使用

如果你的学校使用 Brightspace，你可以在同一个应用中，将 brightspace-d2l-mcp 与 Essay Stats MCP 一起运行。该服务有自己的设置步骤，请按照其 README 进行安装和登录。Essay Stats MCP 不会与它通信，也不依赖它。

将两者都添加到 MCP 配置后，你可以让助手查找作业详情中的字数上限，然后将该数字和你的草稿一起传给 check_word_limit。例如：

• “在 Brightspace 中查找我的历史论文的字数上限，然后检查这份草稿是否符合要求，并排除参考文献。”
• “查找我的作业说明，然后告诉我这份草稿是否低于字数上限，以及有多少页。”

作业详情由另一个服务提供。字数统计和检查则在这里、你的设备上完成，Essay Stats MCP 不会发起网络请求。

隐私

所有计算都由一个小型 Node.js 程序在本地完成，该程序通过标准输入和输出与应用通信。它不会发起网络请求，不会存储任何内容，也不需要密钥或密码。你粘贴的文本只用于这一次调用，之后便会丢弃。

开发

npm install
npm run build
npm test

更多免费的学生 MCP 服务

全部免费、开源；涉及你的账户时均为只读。前往 brightspacemcp.com/more-mcps 浏览完整列表。

服务	功能
Brightspace MCP	面向 AI 的 D2L Brightspace。提供截止日期及真实提交状态、成绩、目标成绩计算器和课程文件。
Canvas MCP	面向 AI 的 Canvas LMS，只读。提供截止日期、未完成作业、成绩和公告。
Moodle MCP	面向 AI 的 Moodle，只读。提供截止日期、逾期作业、成绩和公告。
Google Classroom MCP	面向 AI 的 Google Classroom，只读。提供待办事项、截止日期、未完成作业和成绩。
GPA Calculator MCP	面向 AI 的 GPA、成绩换算和期末考试所需成绩计算器。离线可用，无需账户。
Citations MCP	根据 DOI、ISBN 或输入的详细信息生成 APA、MLA 和 Chicago 引用。无需账户。
Study Planner MCP	制定考试学习计划、间隔重复日期、番茄钟计划和作业里程碑。离线可用。
Paper Finder MCP	通过 OpenAlex 搜索学术论文、查找开放获取版本和相关研究。无需密钥。
BibTeX Reference Manager MCP	清理、转换、去重和检查 BibTeX、RIS 和 CSL JSON 参考文献列表，并生成引用键。离线可用。
Open Textbook Finder MCP	在 OpenStax、DOAB 和 Open Library 上查找免费的合法教材版本，根据 ISBN 查找版次，并推荐更便宜的旧版。
STEM Calculator MCP	化学和物理作业计算：摩尔质量、配平方程式、克与摩尔换算、单位换算和有效数字。离线可用。
Syllabus to Calendar MCP	教学大纲转日历 MCP 服务。从教学大纲文本中提取日期、创建 ics 日历、展开重复课程并合并日历。离线可用，无需账户。
Job Application Tracker MCP	求职申请跟踪 MCP 服务。离线跟踪实习、工作、面试和截止日期，查看近期安排，并将列表导出为 CSV 或 Markdown。无需账户和 API 密钥。

许可证

MIT