Skip to main content

A code analysis tool using Model Context Protocol

Project description

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: 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0.tar.gz.

File metadata

  • Download URL: iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0.tar.gz
  • Upload date:
  • Size: 64.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c631456c96fc4534bc1b2aea2fa92b136dd54195e5b5bd95c6a3767769fa3ffc
MD5 d5f79cf588fdef6ae3f8ee5851c7af13
BLAKE2b-256 4fab5c16b00bab7c36f09adfb9b6147b245949f8b6108167eb13c05b17edc073

See more details on using hashes here.

File details

Details for the file iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 61.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_emiryasar_mcp_code_analyzer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b1e4533453b915e2710219f4f127aac0b680381e86409a38a15c09308e3a78a7
MD5 7ef09797e6c7218f6f8978205bc761b5
BLAKE2b-256 3732b00e88199463a6fd9aef09c45f0e3390ca417732b457d2bd175acf993237

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page