MCP Probe Kit

Instructions

Implementation Reference

• src/tools/analyze_project.ts:46-139 (handler)

  The core handler function for the 'analyze_project' tool. It takes arguments like project_path, max_depth, and include_content, performs analysis, and returns a structured Markdown report with project structure, directory tree, key files, dependencies, code metrics, architecture, and summary.

  export async function analyzeProject(args: any): Promise<any> {
    const projectPath = args.project_path || process.cwd();
    const maxDepth = args.max_depth || 5;
    const includeContent = args.include_content !== false;
  
    try {
      console.error(`开始分析项目: ${projectPath}`);
      const analysis = await performProjectAnalysis(projectPath, maxDepth, includeContent);
      
      return {
        content: [
          {
            type: "text",
            text: `# 📊 项目分析报告
  
  ## 🏗️ 项目概览
  - **项目名称**: ${analysis.projectStructure.name}
  - **项目类型**: ${analysis.projectStructure.type}
  - **技术栈**: ${analysis.projectStructure.framework}
  - **主要语言**: ${analysis.projectStructure.language}
  - **包管理器**: ${analysis.projectStructure.packageManager}
  
  ## 📁 目录结构
  \`\`\`
  ${analysis.directoryTree}
  \`\`\`
  
  ## 🔑 关键文件
  ${analysis.keyFiles.map(file => 
    `### ${file.path}
  **用途**: ${file.purpose}
  ${includeContent ? `\`\`\`${getFileExtension(file.path)}
  ${file.content.substring(0, 500)}${file.content.length > 500 ? '\n...' : ''}
  \`\`\`` : ''}`).join('\n\n')}
  
  ## 📦 依赖分析
  - **生产依赖**: ${analysis.dependencies.production.length} 个
  - **开发依赖**: ${analysis.dependencies.development.length} 个
  - **总依赖数**: ${analysis.dependencies.total} 个
  
  ### 主要依赖
  ${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n')}
  
  ## 📈 代码指标
  - **总文件数**: ${analysis.codeMetrics.totalFiles}
  - **总行数**: ${analysis.codeMetrics.totalLines}
  ${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
  - **文件类型分布**:
  ${Object.entries(analysis.codeMetrics.fileTypes)
    .sort(([, a], [, b]) => (b as number) - (a as number))
    .slice(0, 10)
    .map(([type, count]) => `  - ${type}: ${count} 个文件`)
    .join('\n')}
  ${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
  
  ### 最大文件
  ${analysis.codeMetrics.largestFiles.slice(0, 5).map(file => 
    `- ${file.path} (${file.lines} 行)`
  ).join('\n')}
  
  ## 🏛️ 架构分析
  - **设计模式**: ${analysis.architecture.patterns.join(', ')}
  - **入口文件**: ${analysis.architecture.entryPoints.join(', ')}
  - **核心模块**: ${analysis.architecture.mainModules.join(', ')}
  
  ## 📋 项目总结
  **项目目的**: ${analysis.summary.purpose}
  **复杂度**: ${analysis.summary.complexity}
  **建议**: 
  ${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
  
  ---
  *分析完成时间: ${new Date().toLocaleString('zh-CN')}*
  *分析工具: MCP Probe Kit v${VERSION}*
  
  **分析说明**:
  - 大型项目会自动采样分析，限制最多扫描 5000 个文件
  - 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
  - 单个文件大小限制: 1MB，超过则跳过`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `❌ 项目分析失败: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:427-448 (schema)

  Tool registration in ListToolsRequestSchema handler, including the input schema defining parameters for project_path, max_depth, and include_content.

  {
    name: "analyze_project",
    description: "【项目分析】深度分析项目结构、代码质量和架构，帮助AI快速理解老项目",
    inputSchema: {
      type: "object",
      properties: {
        project_path: {
          type: "string",
          description: "项目路径（默认当前目录）",
        },
        max_depth: {
          type: "number",
          description: "目录树最大深度（默认 5）",
        },
        include_content: {
          type: "boolean",
          description: "是否包含文件内容（默认 true）",
        },
      },
      required: [],
    },
  },

• src/index.ts:525-527 (registration)

  Registration and dispatch logic in the CallToolRequestSchema switch statement, invoking the analyzeProject handler.

  case "analyze_project":
    return await analyzeProject(args);

• src/tools/index.ts:23-23 (registration)

  Re-export of the analyzeProject function from its implementation module, making it available for import in src/index.ts.

  export { analyzeProject } from "./analyze_project.js";

• src/tools/analyze_project.ts:5-44 (schema)

  TypeScript interface defining the internal structure of the project analysis result, used for output validation and typing.

  interface ProjectAnalysis {
    projectStructure: {
      name: string;
      type: string;
      framework: string;
      language: string;
      packageManager: string;
    };
    directoryTree: string;
    keyFiles: Array<{
      path: string;
      purpose: string;
      content: string;
    }>;
    dependencies: {
      production: string[];
      development: string[];
      total: number;
    };
    codeMetrics: {
      totalFiles: number;
      totalLines: number;
      fileTypes: Record<string, number>;
      largestFiles: Array<{
        path: string;
        lines: number;
      }>;
      skippedFiles: number;
    };
    architecture: {
      patterns: string[];
      entryPoints: string[];
      mainModules: string[];
    };
    summary: {
      purpose: string;
      complexity: 'low' | 'medium' | 'high';
      recommendations: string[];
    };
  }