Mcp_code_analyzer

7 forks

29 stars

Free

What is mcp_code_analyzer

mcp_code_analyzer is a powerful tool designed to intelligently adapt changes within a project. Developed by emiryasar, this tool is part of the Model Context Protocol (MCP) suite, which integrates seamlessly with AI systems like Claude Desktop. Its primary function is to analyze code at both the project and file levels, ensuring that any modifications or structural adjustments are reflected across related usages throughout the project. This proactive approach helps maintain consistency and integrity within your codebase.

Despite its capabilities, the tool is still undergoing development to address existing bugs and improve functionality. Users are advised to exercise caution and always backup their codebase before using any modification features.

How to Use mcp_code_analyzer

To start using mcp_code_analyzer, ensure that you have Python 3.10 or later installed on your Windows system, as Linux and MacOS support hasn't been fully tested. Install the tool by cloning the repository and setting it up with the necessary dependencies.

Once installed, integrate it with Claude Desktop by configuring the claude_desktop_config.json file. This setup allows you to specify which project paths you want to analyze and lets you initiate code analysis directly from Claude. You can configure multiple project paths, and the tool can analyze additional files or directories as specified via chat messages.

Important Note: The tool performs file operations that could modify or delete files, so it's crucial to back up your files before proceeding with any operations.

Key Features of mcp_code_analyzer

mcp_code_analyzer comes equipped with a range of features designed to streamline code management and analysis:

Project Analysis:
- Analyze project structure using XML tree format.
- Generate project statistics for better insights.
- Understand technology stacks used within the project.
- Assess code structure to identify areas needing attention.
Code Analysis:
- Analyze imports and find references within the code.
- Conduct file-specific analysis to understand dependencies and interactions.
File Operations:
- Perform file operations with a backup feature to protect your data.
- Use version control to create dated backups, allowing easy retrieval of previous code states.
Code Modification:
- Modify code line by line, though this feature currently experiences significant issues, necessitating careful use and backups.

The tool also features several components in the testing phase, such as syntax checking and pattern recognition, which aim to further enhance its analytical capabilities. Users should be aware of known issues like chat context limitations, which may affect large file modifications, and the impact of AI-generated comments on code operation.

In summary, mcp_code_analyzer is a promising tool for developers looking to maintain and adapt their projects intelligently, with ongoing improvements to enhance its reliability and functionality.

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 
cd mcp-code-analyzer
# Install dependencies and package
pip install -e .

Claude Desktop Integration

Configuration

Access Claude Desktop config:

Win + R → %AppData%\Claude\

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

Chat context limitations may interrupt large file modifications
AI-generated documentation comments can affect code operation in large files

Demo Video

Watch demonstration of MCP tool using with building Mario game: Mario Game with Claude | MCP Code Analyzer Tool Demonstration 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.

How to Use

To use the mcp_code_analyzer, follow these steps:

Visit https://github.com/emiryasar/mcp_code_analyzerhttps://github.com/emirya...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using mcp_code_analyzer capabilities within your Claude conversations

Additional Information

Created

December 2, 2024

Company

emiryasar

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More