FileScopeMCP Server
FileScopeMCP provides semantic codebase awareness to AI assistants by continuously monitoring files, ranking them by importance based on dependency analysis, and maintaining AI-generated summaries through a background LLM broker. The server exposes tools including `find_important_files`, `get_file_summary`, `detect_cycles`, and `list_files` with importance scores, enabling Claude, Cursor, or other AI tools to understand code structure without reading source directly. It solves the problem of AI tools lacking real codebase context by automatically tracking dependencies across 12 languages, detecting changes via AST-level diffing, and serving a visual dashboard for exploring projects.
- GitHub stars
- 291
- tools
- 17
- last updated
- Jan 27, 2026
Tools
17 toolsPublic tool metadata for what this MCP can expose to an agent.
statusBroker connection, queue depth, LLM progress, watcher state
Broker connection, queue depth, LLM progress, watcher state
No parameter schema in public metadata yet.
find_important_filesTop files by importance score with dependency counts
Top files by importance score with dependency counts
No parameter schema in public metadata yet.
get_file_summaryEverything about a file: summary, concepts, change impact, exports, deps, staleness
Everything about a file: summary, concepts, change impact, exports, deps, staleness
No parameter schema in public metadata yet.
list_filesFull file tree (no args) or flat top-N by importance (with maxItems)
Full file tree (no args) or flat top-N by importance (with maxItems)
No parameter schema in public metadata yet.
find_symbolResolve a symbol name to file + line range; supports prefix match via trailing *
Resolve a symbol name to file + line range; supports prefix match via trailing *
No parameter schema in public metadata yet.
find_callersFind all symbols that call a named symbol (TS/JS call graph)
Find all symbols that call a named symbol (TS/JS call graph)
No parameter schema in public metadata yet.
find_calleesFind all symbols that a named symbol calls (TS/JS call graph)
Find all symbols that a named symbol calls (TS/JS call graph)
No parameter schema in public metadata yet.
searchSearch file metadata across symbols, summaries, purpose, and paths
Search file metadata across symbols, summaries, purpose, and paths
No parameter schema in public metadata yet.
list_changed_sinceFiles changed since a timestamp or git SHA
Files changed since a timestamp or git SHA
No parameter schema in public metadata yet.
get_communitiesLouvain-clustered file groups by import coupling
Louvain-clustered file groups by import coupling
No parameter schema in public metadata yet.
detect_cyclesFind circular dependency chains
Find circular dependency chains
No parameter schema in public metadata yet.
get_cycles_for_fileCycles involving a specific file
Cycles involving a specific file
No parameter schema in public metadata yet.
scan_allQueue files for LLM summarization via the broker
Queue files for LLM summarization via the broker
No parameter schema in public metadata yet.
set_base_directoryPoint at a different project
Point at a different project
No parameter schema in public metadata yet.
set_file_summaryManually set or override a file's LLM summary
Manually set or override a file's LLM summary
No parameter schema in public metadata yet.
set_file_importanceManually set a file's importance score (0-10)
Manually set a file's importance score (0-10)
No parameter schema in public metadata yet.
exclude_and_removeDrop files/patterns from tracking (destructive)
Drop files/patterns from tracking (destructive)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
FileScopeMCP
Your AI already knows how to code. Now it knows your codebase.
FileScopeMCP watches your code, ranks every file by importance, maps all dependencies, and keeps AI-generated summaries fresh in the background. When your LLM asks "what does this file do?" — it gets a real answer without reading the source.
Works with Claude Code, Hermes Agent, Codex, OpenClaw, Cursor AI, or as a standalone daemon. Supports TypeScript, JavaScript, Python, C, C++, Rust, Go, Ruby, Lua, Zig, PHP, C#, and Java.
Key Features
Importance ranking — every file scored 0-10 based on how many things depend on it, what it exports, and where it lives. Your LLM sees the critical files first.
Details
- Repository
- github.com/admica/filescopemcp