analyze_project_structure

Analyze project structure to identify technology stacks and architecture patterns for development planning and optimization.

Instructions

分析项目结构，识别技术栈和架构

Input Schema

TableJSON Schema

Name	Required	Description	Default
`path`	No	项目根目录路径（默认当前目录）

Implementation Reference

src/server.ts:790-853 (handler)

Main execution logic for the analyze_project_structure tool. Analyzes project directory by detecting package.json dependencies, config files for various tech stacks (Node.js, React, etc.), lists top-level directories, and generates a markdown report with suggestions.

        case 'analyze_project_structure': {
          const { path: projectPath = '.' } = args as { path?: string };
          const fullPath = join(process.cwd(), projectPath);
          
          if (!existsSync(fullPath)) {
            throw new Error(`路径不存在: ${projectPath}`);
          }
          
          // 检测项目特征
          const features: string[] = [];
          const techStack: string[] = [];
          
          // 检测 package.json
          const pkgPath = join(fullPath, 'package.json');
          if (existsSync(pkgPath)) {
            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
            features.push('Node.js 项目');
            
            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
            if (deps.react) techStack.push('React');
            if (deps.vue) techStack.push('Vue');
            if (deps.angular) techStack.push('Angular');
            if (deps.next) techStack.push('Next.js');
            if (deps.express) techStack.push('Express');
            if (deps.nestjs || deps['@nestjs/core']) techStack.push('NestJS');
            if (deps.typescript) techStack.push('TypeScript');
            if (deps.tailwindcss) techStack.push('TailwindCSS');
          }
          
          // 检测其他配置文件
          if (existsSync(join(fullPath, 'tsconfig.json'))) features.push('TypeScript 配置');
          if (existsSync(join(fullPath, 'docker-compose.yml')) || existsSync(join(fullPath, 'Dockerfile'))) features.push('Docker 支持');
          if (existsSync(join(fullPath, '.github'))) features.push('GitHub Actions');
          if (existsSync(join(fullPath, 'pyproject.toml')) || existsSync(join(fullPath, 'requirements.txt'))) features.push('Python 项目');
          if (existsSync(join(fullPath, 'Cargo.toml'))) features.push('Rust 项目');
          if (existsSync(join(fullPath, 'go.mod'))) features.push('Go 项目');
          
          // 统计目录结构
          const dirs = readdirSync(fullPath).filter(f => {
            const stat = statSync(join(fullPath, f));
            return stat.isDirectory() && !f.startsWith('.') && f !== 'node_modules';
          });
          
          const analysis = `# 🏗️ 项目结构分析

## 项目类型
${features.length > 0 ? features.map(f => `- ${f}`).join('\n') : '- 未识别'}

## 技术栈
${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- 未检测到常用框架'}

## 目录结构
${dirs.map(d => `- 📁 ${d}/`).join('\n') || '- (空目录)'}

## 建议
${techStack.includes('React') ? '- 前端任务可分配给 **frontend** 专家' : ''}
${techStack.includes('Express') || techStack.includes('NestJS') ? '- 后端任务可分配给 **backend** 专家' : ''}
${features.includes('TypeScript 配置') ? '- 项目使用 TypeScript，专家应输出类型安全的代码' : ''}
${features.includes('Docker 支持') ? '- 部署相关任务可考虑添加 **devops** 自定义专家' : ''}`;

          return {
            content: [{ type: 'text', text: analysis }],
          };
        }

src/server.ts:344-356 (registration)

Tool registration including name, description, and input schema (optional path parameter).

{
  name: 'analyze_project_structure',
  description: '分析项目结构，识别技术栈和架构',
  inputSchema: {
    type: 'object',
    properties: {
      path: {
        type: 'string',
        description: '项目根目录路径（默认当前目录）',
      },
    },
  },
},

src/server.ts:347-355 (schema)

Input schema definition for the tool, specifying an optional 'path' string parameter.

inputSchema: {
  type: 'object',
  properties: {
    path: {
      type: 'string',
      description: '项目根目录路径（默认当前目录）',
    },
  },
},

Claude Team MCP