FileScopeMCP
TypeScript代码依赖分析与可视化工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FileScopeMCP。 它的用途是：TypeScript代码依赖分析与可视化工具 完整的 Skill 内容见：https://321skill.com/skills/filescopemcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 FileScopeMCP 分析 src 目录下的所有文件，找出循环依赖并生成 Mermaid 图。' 它会扫描项目，检测到 A -> B -> C -> A 的循环依赖，并输出可视化图表和警告。
对AI说：'帮我梳理这个 React 项目的组件依赖树，只展示 src/components 下的文件。' 它会过滤出指定路径，生成层级依赖图，并标注每个组件的引用次数。
介绍
FileScopeMCP 是一款基于 TypeScript 开发的代码分析工具，专注于帮助开发者快速理解项目中的依赖关系。它通过静态分析代码结构，自动提取模块间的引用链路，并支持将分析结果以可视化图表的形式呈现，让开发者能够直观看到组件、模块、文件之间的依赖网络。
使用方式简单：开发者只需向 AI 助手（如 Claude）发送分析指令，FileScopeMCP 会扫描项目目录，识别所有导入/导出语句，生成依赖图谱。你还可以指定过滤条件，比如只关注某个文件夹或文件类型，或导出为 SVG/PNG 等格式。
适合后端开发、全栈开发、前端开发等需要频繁重构或审查代码的工程师。尤其适合在接手旧项目、进行代码审计、排查循环依赖或优化分包方案时使用。对于技术负责人或项目经理，也可用于快速掌握项目架构。
注意事项：目前仅支持 TypeScript/JavaScript 项目，对于其他语言（如 Python、Java）暂不支持。分析大型项目（如超过 10 万行代码）时可能需要较长时间，建议先按文件夹或模块范围分析。依赖可视化基于 Mermaid.js 或 Graphviz，需确保相关环境已安装。
核心特点
相比其他代码分析工具（如 Dependify、Madge），FileScopeMCP 原生集成在 MCP 协议中，可在 Claude 等 AI 助手中直接调用，无需手动切换工具；同时支持实时交互式依赖查询与可视化导出，适合团队协作场景。
注意事项
仅支持 TypeScript/JavaScript 项目，且对非标准模块语法（如 Babel 自定义插件）可能解析失败。
常见问题
FileScopeMCP 支持分析大型项目吗？
支持，但建议按模块或文件夹分批分析，以避免性能瓶颈。对于超过 10 万行代码的项目，可先使用过滤功能缩小范围。
可视化结果能导出哪些格式？
支持导出为 Mermaid 格式（可嵌入 Markdown）、SVG 和 PNG 图片，方便在文档或演示中使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/filescopemcp/raw/index.md 读取 FileScopeMCP 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/filescopemcp/raw/index.md（查看排版版本）