一个MCP Server,帮助LLM查找相关代码在文件中的位置,支持返回完整的函数定义。An MCP Server, which helps the LLM find the location of relevant code within files and supports returning the complete function definitions.
Single tool 'search-files' has a moderately detailed description in Chinese, but critical gaps undermine quality. Input schema is present with 5 parameters (query, cwd, filePattern, excludePatterns, excludeDirs), all with type definitions and descriptions. However, the tool name lacks a clear action verb (should be 'search_code_identifiers' or 'find_code_definitions'), and descriptions are in Chinese, limiting LLM comprehension in English-first environments. No output schema is documented, the code references SearchResult[] but the structure is not visible in the provided source. Error handling is minimal (console.error calls but no structured recovery guidance). The tool performs a single, well-defined action (code search), but lacks the polish expected of production tools.
在指定目录中搜索代码标识符并返回其完整定义。此工具帮助查找变量、函数、类等定义的具体实现代码,而不仅是引用位置。通过获取完整的代码定义及其上下文,有助于理解代码的内部逻辑、数据流和依赖关系,从而更好地分析和解释代码功能。
Tool name 'search-files' lacks action verb; should be 'search_code' or 'find_definitions' to signal intent clearly to LLMs.
Description is in Chinese; LLMs trained primarily on English will struggle to parse intent. Provide English description as primary.
Output schema (SearchResult structure) is not documented in tool definition. LLMs cannot plan downstream calls or extract fields without knowing return structure.
No error handling guidance. Errors are logged to stderr but tool does not return structured error messages with recovery hints (e.g., 'Unsupported file type: .go. Supported: .ts, .js, .py, .java').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Parameter 'filePattern' and 'excludePatterns' lack examples or constraints. LLMs may pass invalid glob patterns. Add format hints: 'glob pattern (e.g., *.ts, src/**/*.js)'.