Code Analysis MCP Server

A Model Context Protocol (MCP) server that enables AI models to understand and analyze codebases through natural language conversations.

✨ Highlights

• Natural Code Exploration: Ask high-level questions about your codebase

  "What are all the different payment providers integrated in the system?"

• Deep Code Understanding: Extract insights about data models and system architecture

  "How does the user authentication flow work from frontend to database?"

• Dynamic Analysis: Trace data flows and understand system relationships

  "Show me all the places where we calculate transaction fees"

Limitations

This tool is a simpler alternative to more sophisticated code analysis tools / copilot like Aider. While it lacks the advanced code analysis capabilities and robustness of tools like Aider, it offers a lightweight solution for codebase exploration if you already have a Claude Pro subscription. The main advantages are:

• Cost-Effective: Using your existing Claude Pro subscription means no additional API costs, unlike tools that can get expensive when analyzing large codebases

• Simple Setup: Quick to get started with minimal configuration

• Basic Analysis: Good for high-level code understanding and exploration

Note that due to its simpler approach to code analysis, it may make more errors or provide less detailed insights compared to more specialized tools.

🚀 Quick Start

1. Install the server:

2. Install Claude Desktop App. For more instructions on setting up an MCP Server with Claude Desktop app, see docs

3. Configure the server in Claude Desktop's configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

4. Restart Claude Desktop and start analyzing your code!

5. Ensure the tool is correctly setup

• Clicking the tools icon should display the code-analysis tools

• Clicking the integrations button should display the analyze_code_repository prompt

💡 Example Usage

Here's how you might use the tool to understand a complex codebase:

Start by clicking on the analyze_code_repository prompt shown below. That will guide you through the process to initialize the repo and get started.

🔧 Available Tools

initialize_repository

Initialize a code repository for analysis:

get_repo_info

Retrieve information about the initialized repository:

get_repo_structure

Examine repository file structure:

read_file

Read and analyze specific files:

⚙️ Technical Details

• Default scanning depth: 3 levels

• Maximum file size: 1MB

• Maximum lines per file: 1000

• Ignores paths listed in .gitignore

• Local file system access only

• Validates file paths to prevent directory traversal

📝 License

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