FileScopeMCP

你的 AI 已经知道如何编程。现在它也了解你的代码库了。

FileScopeMCP 会监视你的代码，根据重要性对每个文件进行排名，映射所有依赖关系，并在后台保持 AI 生成的摘要处于最新状态。当你的 LLM 询问“这个文件是做什么的？”时，它无需读取源代码即可获得准确的答案。

适用于 Claude Code、Cursor AI，或作为独立守护进程运行。开箱即支持 12 种语言。

主要功能

重要性排名 — 每个文件的评分范围为 0-10，基于有多少内容依赖于它、它导出了什么以及它所处的位置。你的 LLM 会优先看到关键文件。

依赖映射 — 支持 Python、JS/TS、C/C++、Rust、Go、Ruby、Lua、Zig、PHP、C#、Java 的双向导入跟踪。还能发现循环依赖。

始终保持最新 — 文件监视器 + 语义变更检测意味着元数据会自动更新。针对 TS/JS 进行 AST 级差异分析，对其他语言则使用 LLM 驱动的分析。仅重新处理实际发生变更的部分。

LLM 代理 — 后台进程通过 llama.cpp 的 llama-server（或任何兼容 OpenAI 的 HTTP API）协调所有 AI 工作。优先级队列确保交互式查询优先于后台处理。可在单 GPU 上运行。

Nexus 仪表板 — 一个位于 localhost:1234 的 Web UI，让你可以在所有仓库中直观地探索代码库。包括交互式依赖图、文件详情面板、实时代理活动以及各仓库的健康监控。

Related MCP server: GonMCPtool

快速入门

git clone https://github.com/admica/FileScopeMCP.git
cd FileScopeMCP
./build.sh          # installs deps, compiles, registers with Claude Code

就是这样。在任何项目中打开 Claude Code 会话，FileScopeMCP 就会自动初始化。尝试：

find_important_files(limit: 5)
status()

需要 AI 摘要吗？ 运行 ./setup-llm.sh 获取针对特定平台的 llama.cpp llama-server 设置指南 — 详情请参阅 docs/llm-setup.md。如果不设置，其他功能依然可以正常工作。

添加到项目的 .gitignore 中：

.filescope/
.filescope-daemon.log

MCP 工具

Nexus 仪表板

npm run nexus       # opens at http://localhost:1234

一个只读的 Web 仪表板，连接到你机器上的每个 FileScopeMCP 仓库：

• 项目视图 — 带有重要性热力颜色和陈旧度指示器的文件树，点击任何文件即可查看完整元数据

• 依赖图 — 交互式 Cytoscape.js 可视化，支持按目录过滤，点击节点进行检查

• 系统视图 — 实时代理状态、每个仓库的 Token 使用量、流式活动日志

• 设置 — 管理显示的仓库，从黑名单中移除或恢复

通过扫描 .filescope/data.db 目录自动发现仓库。无需配置。

工作原理

Your code changes
    → file watcher picks it up
    → AST diff classifies the change (exports? types? body only?)
    → importance scores recalculated
    → staleness cascades to dependents (only if exports/types changed)
    → LLM broker regenerates summaries, concepts, change impact
    → your AI's next query gets fresh answers

所有内容都存储在每个项目的 .filescope/data.db（SQLite，WAL 模式）中。代理通过 ~/.filescope/broker.sock 的 Unix 套接字协调所有仓库的 LLM 工作。

文档

许可证

Copyright (c) 2026 admica. 保留所有权利。请参阅 LICENSE。