FileScopeMCP

FileScopeMCP

Instantly understand and visualize your codebase structure & dependencies!

Overview

This MCP server analyzes your codebase to identify the most important files based on dependency relationships. It generates importance scores for each file, tracks bidirectional dependencies, and allows you to add custom summaries for files. All this information is made available to AI tools through Cursor's Model Context Protocol.

Features

• File Importance Analysis: Rank files by their role, pinpoint critical files, and calculate importance using dependencies.
• Dependency Tracking: Map relationships between files and distinguish between local and package dependencies.
• Visualization: Generate diagrams to visualize file relationships with color-coded visualizations.
• File Summaries: Add summaries to files and retrieve them easily.
• Multiple Project Support: Manage multiple file trees for different projects.
• Persistent Storage: Save data in JSON format and load existing file trees efficiently.

How It Works

The tool scans source code to detect dependencies using language-specific patterns and assigns importance scores based on several criteria. It generates diagrams using a structured phase approach and normalizes paths for cross-platform compatibility.

Technical Details

• Built with TypeScript/Node.js and employs Model Context Protocol.
• Implements caching and JSON Storage for performance and persistence.

Available Tools

• File Tree Management, File Analysis, File Summaries, File Watching, Diagram Generation

Usage Examples

• Analyzing a project, working with summaries, generating diagrams, and using file watching.

Future Improvements

• Support for more languages, enhanced algorithms, added diagram customization options.