MCP server for detecting repositories and generating README files with automatic feature detection and documentation generation
This server has 4 tools with schemas present and basic descriptions. However, there are critical gaps: descriptions are in Chinese (non-standard for production tools), lack clarity on tool purposes, missing output schema documentation, and several parameters lack descriptions. Tool naming is reasonable (detectRepo, generateReadme, writeFile, generateReadmePro) but descriptions do not follow LLM-optimization patterns. The 'writeFile' tool has a dangerous confirmation pattern that is weak. No error handling guidance, no permission gates despite write operations, and no structured output documentation. This is a fair-to-poor implementation typical of early-stage community servers.
读取指定目录的 package.json 并返回关键信息
生成基础 README 文档
生成专业级 README 文档(GitHub 风格),包含目录、特性、脚本、项目结构、API 端点、环境变量和技术栈
写入文件内容到指定路径
Descriptions are in Chinese, making them inaccessible to international LLM agents and violating English documentation standards for production MCP servers.
No output schema documentation for any tool. LLMs cannot plan downstream calls or extract required fields without knowing the response structure.
writeFile tool has weak confirmation: boolean 'confirm' parameter with default false means LLM can overwrite files without explicit safeguard. Missing dry-run or confirmation request pattern for destructive operation.
No error handling or recovery guidance in descriptions. Tools provide no actionable error messages for invalid input, missing files, or API failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 47 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 0 | - | v1 |
Parameter descriptions are incomplete or generic. 'dir' parameter only says '目录路径(可选,默认当前目录)' without explaining what behavior changes if omitted or how the tool uses it.
generateReadmePro's 'language' enum is ['zh','en'] but descriptions and all other strings are in Chinese. Mismatch between English language option and actual Chinese output.
No permission gates or audit trail for writeFile, which modifies the filesystem. No indication of which agent/user is performing the write, no logging of what was overwritten.
detectRepo, generateReadme, and generateReadmePro all read from 'dir' parameter and infer project metadata. No validation of input directory existence or permission checks before reading.