Ranks files by importance from dependency relationships, generates diagrams and summaries to help agents understand a codebase.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add filescopemcp --env BASE_DIR='<BASE_DIR>' -- node '<build script sets this>/mcp-server.js' '--base-dir={{config.BASE_DIR}}'~/.codex/config.toml
[mcp_servers.filescopemcp]
command = "node"
args = ["<build script sets this>/mcp-server.js", "--base-dir={{config.BASE_DIR}}"]
env = { BASE_DIR = "<BASE_DIR>" }
# codex mcp add filescopemcp --env BASE_DIR='<BASE_DIR>' -- node '<build script sets this>/mcp-server.js' '--base-dir={{config.BASE_DIR}}'~/.cursor/mcp.json
{
"mcpServers": {
"filescopemcp": {
"command": "node",
"args": [
"<build script sets this>/mcp-server.js",
"--base-dir={{config.BASE_DIR}}"
],
"env": {
"BASE_DIR": "<BASE_DIR>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"filescopemcp": {
"type": "stdio",
"command": "node",
"args": [
"<build script sets this>/mcp-server.js",
"--base-dir={{config.BASE_DIR}}"
],
"env": {
"BASE_DIR": "<BASE_DIR>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"filescopemcp": {
"command": "node",
"args": [
"<build script sets this>/mcp-server.js",
"--base-dir={{config.BASE_DIR}}"
],
"env": {
"BASE_DIR": "<BASE_DIR>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"filescopemcp": {
"command": "node",
"args": [
"<build script sets this>/mcp-server.js",
"--base-dir={{config.BASE_DIR}}"
],
"env": {
"BASE_DIR": "<BASE_DIR>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"filescopemcp": {
"command": "node",
"args": [
"<build script sets this>/mcp-server.js",
"--base-dir={{config.BASE_DIR}}"
],
"env": {
"BASE_DIR": "<BASE_DIR>"
}
}
}
}Environment variables
BASE_DIR
Replace the placeholders with your own credentials and keep them out of version control.