admica/FileScopeMCP

Overview

FileScopeMCP analyzes a codebase by parsing dependency relationships across files. It generates importance scores and diagrams for each file, helping AI assistants understand the project structure. The tool supports Python, C, C++, Rust, Zig, and Lua.

Best for

Best for
Developers working with supported languages who want to give AI tools a structured understanding of their codebase

Use cases

• Identify critical files in a large codebase for refactoring or documentation
• Generate dependency diagrams to visualize module relationships
• Provide AI assistants with a structured map of the codebase for context-aware suggestions

How to use

Install

npm run install-claude-code   # or: npx filescope-install --claude-code

Tools exposed

• find_important_files
• get_file_summary
• list_files
• find_symbol
• find_callers
• find_callees
• list_changed_since
• get_communities
• detect_cycles
• get_cycles_for_file
• scan_all
• set_base_directory
• set_file_summary
• set_file_importance
• exclude_and_remove

Tested with

Claude Code, Cursor, ChatGPT

Notes

FileScopeMCP analyzes a codebase by parsing dependency relationships across files. It generates importance scores and diagrams for each file, helping AI assistants understand the project structure. The tool supports Python, C, C++, Rust, Zig, and Lua.

292 stars on GitHub. Last updated 2026-05-10.

Use cases

• Identify critical files in a large codebase for refactoring or documentation
• Generate dependency diagrams to visualize module relationships
• Provide AI assistants with a structured map of the codebase for context-aware suggestions

Pros

• Automatically parses multiple popular languages without manual configuration
• Produces concrete importance scores and diagrams, not just raw dependency lists
• Open source with 292 stars and active TypeScript codebase

Cons

• Limited to languages it can parse, excluding many others like Java or JavaScript
• Dependency analysis may miss dynamic imports or runtime-resolved dependencies
• Requires integration with an MCP-compatible AI assistant to be useful

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.