MCP Code Analyzer

The main purpose of the MCP tool is to adapt changes to the project intelligently. For instance, when a code modification or structural adjustment is needed, it aims to ensure that other related usages are also updated accordingly.

Currently, the project has a lot of bugs, and the tools are not functioning as expected sometimes. Due to work commitments, I can’t dedicate much time to it, but I’ll try to fix the issues and bring it to a working state whenever I find the time.

⚠️ WARNING: BACKUP RECOMMENDED
This tool performs file operations that could potentially modify or delete files. Always backup your codebase before using any modification features.

Overview

The Model Context Protocol (MCP) Code Analyzer is a comprehensive code analysis and management tool that integrates with Claude Desktop. It analyzes code at both project and file levels, providing insights for needed changes and project understanding.

Prerequisites

• Python 3.10 or later
• Windows (Linux/MacOS support not yet tested)

Installation

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

# Install dependencies and package
pip install -e .

Claude Desktop Integration

Configuration

1. Access Claude Desktop config:

   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 in configuration
• Additional paths or files can be analyzed via chat messages
• No limit on number of analyzable paths/files

🛠️ Tools and Status

Working 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 backup before use)

  • file_operations
  • version_control (Creates dated backups)

• ⚠️🔄 Code Modify (Always backup before use)

  • code_modifier (Performs modifying code line by line)(Currently has big 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 large file modifications
2. AI-generated documentation comments can affect code operation in large files

Demo Video

Watch demonstration of MCP tool using with building Mario game:

Note: This is a demonstration of the tool's capabilities, not a complete game tutorial. While the game isn't fully playable due to Claude's message limits, this video shows how the MCP tool works and what you can do with it.

Contributing

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

License

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

---

Note: This project is under active development. Features and documentation may change frequently.