{"id":50181866,"url":"https://github.com/yoqu/mcp-word-counter","last_synced_at":"2026-05-25T07:04:33.942Z","repository":{"id":303717298,"uuid":"1016440809","full_name":"yoqu/mcp-word-counter","owner":"yoqu","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-09T03:08:06.000Z","size":6983,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-09T00:41:22.915Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yoqu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-09T02:57:13.000Z","updated_at":"2025-07-09T03:08:09.000Z","dependencies_parsed_at":"2025-07-09T04:32:40.340Z","dependency_job_id":null,"html_url":"https://github.com/yoqu/mcp-word-counter","commit_stats":null,"previous_names":["yoqu/mcp-word-counter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yoqu/mcp-word-counter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yoqu%2Fmcp-word-counter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yoqu%2Fmcp-word-counter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yoqu%2Fmcp-word-counter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yoqu%2Fmcp-word-counter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yoqu","download_url":"https://codeload.github.com/yoqu/mcp-word-counter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yoqu%2Fmcp-word-counter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33464012,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T06:32:55.349Z","status":"ssl_error","status_checked_at":"2026-05-25T06:32:35.322Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-25T07:03:22.701Z","updated_at":"2026-05-25T07:04:33.925Z","avatar_url":"https://github.com/yoqu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Word Counter - 中文字数统计服务\n\n一个基于 Model Context Protocol (MCP) 的中文字数统计服务，支持智能统计中文、英文、全角和半角字符。\n\n## 功能特性\n\n- ✅ **智能字符识别**：准确识别中文汉字、英文字符、全角和半角字符\n- ✅ **多文件支持**：同时统计多个文件的字数\n- ✅ **详细统计**：提供每种字符类型的详细统计信息\n- ✅ **智能计算**：按照指定规则计算字数并向上取整\n- ✅ **错误处理**：友好的错误提示和异常处理\n\n## 字数计算规则\n\n| 字符类型 | 计算权重 | 示例 |\n|---------|---------|------|\n| 中文汉字 | 1.0 | 中、文、汉、字 |\n| 英文字符 | 0.5 | a-z, A-Z |\n| 全角字符 | 1.0 | ！、（、） |\n| 半角字符 | 0.5 | !、(、) |\n\n**注意**：最终字数会向上取整。例如：3.2 → 4，5.7 → 6\n\n## 安装与配置\n\n### 方法一：使用 npx（推荐）\n\n直接使用 npx 安装和配置，无需手动下载：\n\n```bash\nnpx mcp-word-counter\n```\n\n在你的 MCP 客户端配置文件中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"word-counter\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-word-counter\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n### 方法二：全局安装\n\n```bash\nnpm install -g mcp-word-counter\n```\n\n配置 MCP 客户端：\n\n```json\n{\n  \"mcpServers\": {\n    \"word-counter\": {\n      \"command\": \"mcp-word-counter\",\n      \"env\": {}\n    }\n  }\n}\n```\n\n### 方法三：本地开发\n\n1. 克隆项目并安装依赖：\n\n```bash\ngit clone https://github.com/yourusername/mcp-word-counter.git\ncd mcp-word-counter\nnpm install\n```\n\n2. 构建项目：\n\n```bash\nnpm run build\n```\n\n3. 配置 MCP 客户端：\n\n```json\n{\n  \"mcpServers\": {\n    \"word-counter\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/mcp-word-counter/dist/index.js\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n## 使用方法\n\n### 在 MCP 客户端中使用\n\n调用 `count_words` 工具：\n\n```json\n{\n  \"name\": \"count_words\",\n  \"arguments\": {\n    \"filePaths\": [\"./example.txt\", \"./document.md\"]\n  }\n}\n```\n\n### 支持的文件格式\n\n- 纯文本文件 (.txt)\n- Markdown 文件 (.md)\n- JavaScript/TypeScript 文件 (.js, .ts)\n- JSON 文件 (.json)\n- 其他任何文本格式文件\n\n## 输出示例\n\n```\n文件: ./example.txt\n总字数: 156\n详细统计:\n  - 汉字: 120\n  - 英文字符: 45\n  - 全角字符: 8\n  - 半角字符: 12\n  - 其他字符: 3\n  - 原始字数: 155.50\n\n文件: ./document.md\n总字数: 89\n详细统计:\n  - 汉字: 78\n  - 英文字符: 20\n  - 全角字符: 2\n  - 半角字符: 5\n  - 其他字符: 1\n  - 原始字数: 88.50\n\n总计字数: 245\n```\n\n## 开发\n\n### 项目结构\n\n```\nmcp-word-counter/\n├── src/\n│   ├── index.ts          # MCP 服务器主文件\n│   ├── word-counter.ts   # 字数统计核心逻辑\n│   └── types.ts          # 类型定义\n├── dist/                 # 编译输出目录\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n### 开发模式\n\n```bash\n# 监听文件变化并自动编译\nnpm run dev\n\n# 运行编译后的服务器\nnpm start\n```\n\n### 测试\n\n创建测试文件并使用 MCP 客户端测试：\n\n```bash\necho \"Hello 世界！This is a test.\" \u003e test.txt\n```\n\n## API 文档\n\n### count_words 工具\n\n统计指定文件的中文字数。\n\n**参数**：\n- `filePaths` (string[]): 要统计的文件路径数组\n\n**返回值**：\n- 每个文件的详细统计信息\n- 总字数统计\n- 错误信息（如果有）\n\n## 技术栈\n\n- **Node.js**: 运行时环境\n- **TypeScript**: 开发语言\n- **MCP SDK**: Model Context Protocol 官方 SDK\n- **ESM**: ES 模块系统\n\n## 许可证\n\nMIT License\n\n## 发布到 npm\n\n如果你想要发布自己的版本：\n\n1. 更新 `package.json` 中的作者信息和仓库地址\n2. 登录 npm：\n   ```bash\n   npm login\n   ```\n3. 发布包：\n   ```bash\n   npm publish\n   ```\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 更新日志\n\n### v1.0.0\n- 初始版本\n- 支持中文字数统计\n- 支持多文件处理\n- 完整的 MCP 集成\n- 支持 npx 直接使用 ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoqu%2Fmcp-word-counter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyoqu%2Fmcp-word-counter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoqu%2Fmcp-word-counter/lists"}