MCP Code Analyzer

🚀 MCP Code Analyzer

The MCP tool is primarily designed to intelligently adapt to project changes. For example, when code modifications or structural adjustments are required, it aims to ensure that other relevant usages are updated accordingly.

Currently, there are many bugs in the project, and the tool sometimes fails to work properly. Due to work commitments, I don't have much time to fix the issues for now, but I'll do my best to resolve them and make the tool functional.

⚠️ Important Note

It is recommended to make a backup. This tool performs file operations and may modify or delete files. Always back up your codebase before using any modification features.

🚀 Quick Start

The Model Context Protocol (MCP) Code Analyzer is a comprehensive code analysis and management tool integrated with Claude Desktop. It analyzes code at the project and file levels, providing insights into required changes and project understanding.

✨ Features

Prerequisites

• Python 3.10 or higher
• Windows (Linux/MacOS support has not been tested yet)

Installation

# Clone the repository
git clone https://github.com/[your-username]/mcp-code-analyzer.git
cd mcp-code-analyzer

# Install dependencies and packages
pip install -e .

Claude Desktop Integration

Configuration

1. Access the Claude Desktop configuration:

   Win + R → %AppData%\Claude\
   

2. Create/Edit claude_desktop_config.json:

   {
     "globalShortcut": "Ctrl+Space",
     "mcpServers": {
       "code-analyzer": {
         "command": "python",
         "args": [
           "-m",
           "mcp_code_analyzer",
           "--analyze-paths",
           "C:\\Projects\\path1"
         ],
         "type": "module"
       }
     }
   }
   

Path Configuration

• Multiple project paths can be specified.
• Additional paths or files can be analyzed via chat messages.
• There is no limit to the number of analyzable paths/files.

Tools and Status

Implemented Tools

• ✅ Project Analysis

  • analyze_project_structure (XML tree format)
  • analyze_project_statistics
  • analyze_project_technology
  • analyze_code_structure

• ✅ Code Analysis

  • analyze_imports
  • analyze_file
  • find_references

• ⚠️🔄 File Operations (Always back up before use)

  • file_operations
  • version_control (Create date backups)

• ⚠️🔄 Code Modification (Always back up before use)

  • code_modifier (Modify code line by line) (Currently has significant issues)

Testing Phase

• 🔄 check_syntax
• 🔄 find_code_patterns
• 🔄 find_pattern_usages
• 🔄 search_content
• 🔄 search_files
• 🔄 validate_code

Known Issues

1. Chat context limitations may interrupt modifications to large files.
2. AI-generated documentation comments may affect code operations in large files.

Demo Video

Watch the demonstration of using the MCP tool to build a Mario game:

Note: This video demonstrates the tool's functionality rather than providing a complete tutorial. Although the game cannot be fully played due to Claude's message limitations, the video shows how the MCP tool works and the operations it can perform.

🤝 Contribution

Contributions are welcome! Whether it's bug reports, feature requests, documentation improvements, or code contributions - every contribution matters. Simply fork the repository and submit a pull request.

📄 License

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