Code Analysis Server

🚀 Code Analysis MCP Server

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

✨ Features

• Natural Code Exploration: Ask high - level questions to understand your codebase.

  "What different payment providers are integrated into the system?"
  

• In - depth Code Understanding: Extract insights into data models and system architectures.

  "What is the user authentication process from the front - end to the database?"
  

• Dynamic Analysis: Track data flow and understand system relationships.

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

Limitations

This tool is an alternative to more sophisticated code analysis tools like Aider. While it lacks the more specialized code analysis features and robustness of Aider, it offers a lightweight solution for codebase exploration if you already have a Claude Pro subscription. The main advantages include:

• Cost - effectiveness: Leveraging an existing Claude Pro subscription means no additional API costs, while other tools can become expensive when analyzing large codebases.
• Simple Setup: Quick start configuration.
• Basic Analysis: Suitable for high - level code understanding and exploration.

Note that due to its simpler approach to code analysis, it may be more error - prone or provide less detailed insights compared to more specialized tools.

🚀 Quick Start

1. Install the server:

git clone https://github.com/saiprashanths/code-analysis-mcp.git
cd code-analysis-mcp

2. Install the Claude Desktop App. For more instructions on setting up the MCP server with the Claude Desktop App, see the documentation.

3. Configure your project:

{
  "projectName": "My Project",
  "description": "This is an example project for code analysis.",
  "ignorePaths": ["\\.git", "node_modules"],
  "maxFileSize": "1MB",
  "maxLinesPerFile": "1000"
}

4. Start the server:

python3 server.py

💻 Usage Examples

Project Structure Scanning

Run the scan-filesystem command to view the file structure:

node src/cli/scan-filesystem.js --path "src/api"
# Output:
# Scanning directory: src/api
# Found file: models.py (2.3KB)
# Found file: helpers.js (156KB)
# Scan completed, 2 files found.

Analyzing Specific Files

Use the analyze-file command to analyze specific files:

node src/cli/analyze-file.js --path "src/api/models.py"
# Output:
# Analyzing file: src/api/models.py
# File language: Python
# File size: 2.3KB
# Content summary: Contains definitions of user and order models.

Interacting with Claude

Interact with Claude using the following command:

node src/cli/chat.js --project "My Project"
# Input:
# Claude: Welcome! I'm the code analysis assistant. How can I help you?
# User: What are the main payment methods in our system?
# Claude: Based on the codebase, I've found the following payment providers: Stripe, PayPal, and Alipay.

🔧 Technical Details

• Default scanning depth: 3 levels
• Maximum file size: 1MB
• Maximum lines per file: 1000
• Ignore paths listed in .gitignore
• Only local file system access is allowed
• Validate file paths to prevent directory traversal

📄 License

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