How do I install the filescopemcp mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

FileScopeMCP MCP Server

Analyzes your codebase identifying important files based on dependency relationships. Generates diagrams and importance scores per file, helping AI

Local serverstdioPython

What is the FileScopeMCP MCP Server?

Analyzes your codebase identifying important files based on dependency relationships. Generates diagrams and importance scores per file, helping AI assistants

What the server does

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.

Credentials and setup notes

Node.js >= 22 and npm (download) - Build tools for native modules (better-sqlite3, tree-sitter): - Linux: sudo apt install build-essential python3 - macOS: xcode-select --install - Windows: Visual Studio Build Tools with C++ workload

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
status	Broker connection, queue depth, LLM progress, watcher state
find_important_files	Top files by importance score with dependency counts
get_file_summary	Everything about a file: summary, concepts, change impact, exports, deps, staleness
list_files	Full file tree (no args) or flat top-N by importance (with maxItems)
find_symbol	Resolve a symbol name to file + line range; supports prefix match via trailing *
find_callers	Find all symbols that call a named symbol (TS/JS call graph)
find_callees	Find all symbols that a named symbol calls (TS/JS call graph)
search	Search file metadata across symbols, summaries, purpose, and paths
list_changed_since	Files changed since a timestamp or git SHA
get_communities	Louvain-clustered file groups by import coupling
detect_cycles	Find circular dependency chains
get_cycles_for_file	Cycles involving a specific file
scan_all	Queue files for LLM summarization via the broker
set_base_directory	Point at a different project

How to install the FileScopeMCP MCP Server

{
  "mcpServers": {
    "filescopemcp": {
      "command": "npx",
      "args": ["-y", "filescope-install"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Node.js >= 22 and npm (download) - Build tools for native modules (better-sqlite3, tree-sitter): - Linux: sudo apt install build-essential python3 - macOS: xcode-select --install - Windows: Visual Studio Build Tools with C++ workload

Example prompts to try

“Use FileScopeMCP to status.”
“Use FileScopeMCP to find important files.”
“Use FileScopeMCP to get file summary.”

Frequently asked questions

Analyzes your codebase identifying important files based on dependency relationships. Generates diagrams and importance scores per file, helping AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.