FileScopeMCP

社区

你的AI已经会写代码，现在它了解你的代码库。

分类: 开发工具第 176 / 438
Stars: ★ 302 热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 5 个月前
工具数: 17

56FMRS · C

FileScopeMCP是一个功能强大的代码分析工具，专为增强AI助手的代码理解能力而设计。它通过重要性评分、依赖映射和符号提取，为AI提供精确的上下文，减少对源代码的读取。安装简单，支持多种语言和客户端。它的实用性广泛，但需要注意启发式评分的局限性，以及依赖本地LLM时的隐私和配置复杂性。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

11/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 源码库中有GitHub Actions构建工作流（.github/workflows/build.yml），表明有CI实践。但未在源码中看到针对核心服务器路径的提交测试；工具列表声称的功能主要依据README，且部分依赖外部LLM组件（llama-server）和原生模块，在无LLM环境下可能降级。由于仅静态审查，无法验证实际运行表现，故保守评分。
安全与权限 12/20: 服务器设计了后台broker和daemon，具有内部Unix socket通信，数据存储在本地SQLite中。未发现明显的凭据硬编码或恶意行为。但存在设置文件摘要和重要性分数的工具，可能允许修改数据；有破坏性操作（exclude_and_remove）但标注了“destructive”，未见显式确认机制。未发现红-line风险。
维护活跃度 11/20: 仓库活跃，有近期提交和构建状态徽章，但许可证显示为'All Rights Reserved'（NOASSERTION），可能存在许可证不明确的问题。未提供安全响应渠道或贡献指南。因此评分中等偏上。
文档质量 14/20: README非常全面，涵盖安装、快速开始、MCP工具、架构、FAQ等，并链接到多个专门文档。但部分高级功能（如Nexus仪表板、监控栈）可能对普通用户复杂，且未详细说明每个工具的参数和限制。文档质量良好。
安装易用性 11/20: 提供了详细的安装步骤（build.sh），需要Node.js >=22和构建工具，支持多平台。通过claude mcp add注册，也支持手动配置。但依赖于原生模块和LLM，增加了部署的复杂性。静态审查中未发现执行证据，故评分不超过15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

需要深度代码库上下文给AI助手的开发者。
希望在开发过程中自动维护代码元数据的团队。
使用多语言项目（支持TS/JS、Python、C/C++、Rust、Go等）。

不适合谁

只需要简单文件列表而不需要依赖分析的场景。
在不支持Node.js >=22的环境中使用。
需要完全离线且无LLM设置的场景（但基础功能仍可用）。

所需权限

文件系统读取和监视权限（扫描代码库）。
写入权限（创建 `.filescope/data.db` 数据库）。
网络权限（可选，用于连接本地LLM端点）。

风险与副作用

重要文件评分是启发式的，可能不符合所有项目偏好。
正则表达式解析语言可能不如AST精确。
LLM摘要依赖外部服务，可能产生隐私风险。
数据库可能在大型代码库中占用显著空间。

安装接入

准备工作

运行环境：Node.js 22+

克隆仓库：git clone https://github.com/admica/FileScopeMCP。
进入目录并运行 ./build.sh，它会安装依赖、编译并注册到Claude Code。
对于其他客户端，参考 docs/mcp-clients.md 手动配置。

claude_desktop_config.json

{
  "type": "stdio",
  "command": "node",
  "args": [
    "/path/to/FileScopeMCP/dist/mcp-server.js"
  ],
  "env": {}
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

生成并校验客户端配置

验证是否装好

按 README 运行 ./build.sh 后，在 Claude Code 中打开任意项目，工具列表中应出现 find_important_files 和 status；调用 status() 若能返回 broker 连接和 watcher 状态，即说明安装成功。

常见排障

确保Node.js >=22已安装，并安装构建工具（如 `build-essential`）。
检查日志 `~/.filescope/data.db` 是否存在，确保监视器正在运行。
如果LLM摘要不生成，确认本地LLM端点已配置且可用。
参考 `docs/troubleshooting.md` 获取常见问题解决方案。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

找出这个项目里最重要的 5 个文件，并说明原因。
谁调用了 parseConfig 这个函数？
这个项目里有没有循环依赖？
文件 src/index.ts 的摘要、导出和依赖是什么？

工具能力 17

status 只读

查看代理连接、队列深度、LLM进度和监视器状态。

find_important_files 只读

按重要性评分列出最高分文件，附带依赖计数。

get_file_summary 只读

获取文件的详细元数据，包括摘要、概念、变更影响、导出、依赖和过时程度。

list_files 只读

列出完整文件树或按重要性排序的Top-N文件。

find_symbol 只读

解析符号名称到文件和行范围，支持前缀匹配。

find_callers 只读

查找调用指定符号的所有符号（适用于TS/JS）。

find_callees 只读

查找指定符号调用的所有符号（适用于TS/JS）。

search 只读

在符号、摘要、用途和路径中搜索文件元数据。

展开其余 9 个工具

list_changed_since 只读

列出自某时间戳或git提交以来更改的文件。

get_communities 只读

获取基于导入耦合的Louvain聚类文件组。

detect_cycles 只读

查找循环依赖链。

get_cycles_for_file 只读

查找涉及特定文件的循环依赖。

scan_all 写入

通过代理将文件排队用于LLM摘要。

set_base_directory 写入

指向不同的项目目录。

set_file_summary 写入

手动设置或覆盖文件摘要。

set_file_importance 写入

手动设置文件重要性评分（0-10）。

exclude_and_remove 破坏性

从跟踪中删除文件/模式（破坏性操作）。

使用场景

AI助手快速理解大型代码库的结构和关键文件。

重构前查找调用关系，评估变更影响。

自动生成并及时更新的文件摘要，供AI使用。

可视化项目依赖图和社区结构。

支持客户端

Claude Desktop

Cursor AI

Codex

依据项目文档列出，未经本站实测。

详细介绍

FileScopeMCP 分析代码库，基于依赖关系识别重要文件，生成依赖图和重要性评分。它支持多种编程语言，自动提取符号和调用关系，并通过文件监视器保持元数据最新。可选地，它使用本地LLM生成文件摘要，并提供Nexus仪表盘进行可视化探索。