Next Analyzer MCP

A Model Context Protocol (MCP) server for analyzing Next.js projects with TypeScript. This tool helps AI assistants quickly understand and work with Next.js projects by providing detailed analysis of project structure, TypeScript definitions, and routing patterns.

Features

• Project Structure Analysis: Automatically maps out your Next.js project structure including pages, components, and API routes
• TypeScript Definition Extraction: Extracts and categorizes TypeScript interfaces and types used throughout the project
• Route Analysis: Comprehensive analysis of static and dynamic routes, including API endpoints
• Data Fetching Pattern Detection: Identifies and analyzes data fetching methods (getStaticProps, getServerSideProps, etc.)
• Component Relationship Mapping: Visualizes component dependencies and relationships

Installation

# Install globally
npm install -g @next-analyzer/mcp

# Or use with npx
npx @next-analyzer/mcp

Integration with Cline

Add the following configuration to your Cline MCP settings:

{
  "mcpServers": {
    "next-analyzer": {
      "command": "npx",
      "args": ["@next-analyzer/mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available Tools

analyze_project_structure

Analyzes the structure of a Next.js project and returns a comprehensive overview.

interface ProjectStructure {
  pages: RouteNode[];
  components: ComponentInfo[];
  apiRoutes: APIRouteInfo[];
  dataFetching: DataFetchingInfo[];
  envVariables: string[];
}

extract_typescript_definitions

Extracts and categorizes TypeScript interfaces and types used in the project.

interface TypeScriptDefinitions {
  interfaces: TypeInfo[];
  types: TypeInfo[];
  props: PropTypeInfo[];
  apiTypes: APITypeInfo[];
}

analyze_routes

Provides detailed analysis of the project's routing structure.

interface RouteAnalysis {
  staticRoutes: RouteInfo[];
  dynamicRoutes: DynamicRouteInfo[];
  apiEndpoints: APIEndpointInfo[];
  middleware: MiddlewareInfo[];
}

Example Usage

// Example of using the MCP server with Cline
const result = await use_mcp_tool({
  server_name: "next-analyzer",
  tool_name: "analyze_project_structure",
  arguments: {
    path: "./my-next-project"
  }
});

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Requirements

• Node.js >= 16.0.0
• Next.js project with TypeScript