READMEmain

MCP Analyzer

A powerful tool for analyzing, planning, and enhancing projects with MCP (Model Context Protocol) tools. This tool helps developers understand their project structure, detect technologies and frameworks, and get recommendations for appropriate MCP tools.

Features

Project Analysis: Automatically detects programming languages, frameworks, and features in your project
Project Planning: Helps plan new projects with appropriate MCP tools and configurations
Project Enhancement: Suggests and adds MCP tools based on new requirements
Smart Detection: Identifies project features like authentication, databases, APIs, and more
Configurable: Customizable scanning limits and detection rules
Cursor Integration: Works as an MCP server within the Cursor editor

Installation

As a global command-line tool:

npm install -g mcp-analyzer

For use with Cursor:

# Install globally to use with Cursor
npm install -g mcp-analyzer

# Configure Cursor to use mcp-analyzer
# Cursor will automatically detect the MCP server

Usage

Project Analysis

Analyze an existing project to detect technologies and recommend MCP tools:

mcp-analyzer analyze /path/to/project

Project Planning

Get recommendations for a new project:

mcp-analyzer plan "A full-stack web application with React frontend and Node.js backend" /path/to/new/project

Project Enhancement

Add new MCP tools to an existing project:

mcp-analyzer enhance /path/to/project "Add real-time features and testing infrastructure"

Cursor Integration

MCP Analyzer can be used directly within the Cursor editor as an MCP server, providing in-editor project analysis, planning, and enhancement capabilities.

Setting Up Cursor Integration

Install MCP Analyzer globally:
```
npm install -g mcp-analyzer
```
Restart Cursor or reload the window
Cursor will automatically detect the MCP server. You should see "cursor-project-assistant" in the list of available MCP tools.

Using MCP Analyzer in Cursor

Once configured, you can use the MCP Analyzer tools directly in Cursor:

Open Cursor editor
Access the MCP menu (typically in the bottom bar or through the command palette)
Select "cursor-project-assistant"
Choose one of the available tools:
- analyze_project: To analyze your current project
- plan_project: To plan a new project with appropriate MCP tools
- enhance_project: To enhance your project with new MCP tools based on new requirements

Example Prompts

You can use the following prompts in Cursor:

"Analyze my current project to recommend MCP tools"
"I want to create a new React Native application with authentication and Firebase integration. Help me plan the project structure."
"I need to add real-time chat functionality to my MERN stack app. Suggest MCP tools that can help."

Configuration

The tool can be configured through the following files:

.cursor/mcp.json: MCP server configuration
.cursor/rules/project_rules.json: Project-specific rules
src/config/project-scan.ts: Scanning and detection settings

Development

Prerequisites

Node.js 18 or higher
TypeScript 5.0 or higher
npm or yarn

Setup

Clone the repository:

git clone https://github.com/yourusername/mcp-analyzer.git
cd mcp-analyzer

Install dependencies:

npm install

Build the project:

npm run build

Running Tests

npm test

For watch mode:

npm run test:watch

Development Mode

npm run dev

Project Structure

mcp-analyzer/
├── src/
│   ├── config/           # Configuration files
│   ├── types/            # TypeScript type definitions
│   ├── utils/            # Utility functions
│   ├── project-analyzer.ts
│   ├── project-planner.ts
│   ├── project-enhancer.ts
│   └── index.ts          # MCP server entry point
├── tests/                # Test files
├── cursor-mcp.json       # Cursor MCP configuration
├── package.json
├── tsconfig.json
└── README.md

Contributing

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

License

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

mcp-analyzer