Awesome MCP › Software Development

admica/FileScopeMCP

⭐ 302 TypeScript added to this list on 2025-05-06 repository created 2025-03-27

FileScopeMCP is a TypeScript-based Model Context Protocol (MCP) server designed to enhance AI-assisted code understanding by analyzing codebases to rank file importance, track dependencies, and generate visual visualizations. It provides a comprehensive analysis of a project's file structure by assigning importance scores to files on a scale from 0 to 10, based on their role and relationships within the codebase. The importance calculation considers factors such as the number of files importing a given file, the number of files it imports, file type, location within the project, and naming conventions. This allows developers and AI tools to quickly identify the most critical files in a project. The server supports bidirectional dependency tracking, mapping which files depend on others and which files are dependencies, distinguishing between local and package dependencies. It supports multiple programming languages including Python, JavaScript, TypeScript, C/C++, Rust, Lua, Zig, C#, and Java, making it versatile for various codebases. FileScopeMCP also generates visualizations using Mermaid diagrams, which can be output as text or HTML with embedded rendering. These diagrams are color-coded based on file importance and can be customized in terms of depth, filtering, and layout. The HTML output is responsive and supports light/dark themes. Users can add human or AI-generated summaries to files, which persist across server restarts, aiding in quick understanding of file purposes. The server supports managing multiple file trees for different project areas, with caching for faster operations and persistent JSON storage for all data. The tool integrates with Cursor's MCP specification, exposing various tools for file tree management, file analysis, summary management, file watching, and diagram generation. It handles path normalization for cross-platform compatibility and offers caching for performance. Installation involves cloning the repository, building the project, and configuring the MCP server with the appropriate base directory. Overall, FileScopeMCP is a powerful MCP server that provides detailed insights into codebase structure and dependencies, facilitating better code comprehension and AI-assisted development workflows.

https://github.com/admica/FileScopeMCP

ai-assistantai-assisted-code-understandingcc++cachingcodebase-analysiscross-platformcursor-integrationdependency-trackingdiagram-generationfile-analysisfile-importancefile-importance-rankingfile-summariesfile-tree-managementfile-watchingjavascriptjson-storageluamcpmcp-servermermaid-diagramsmodel-context-protocolmulti-language-supportpath-normalizationpersistent-storagepythonrusttypescriptvisualizationzig