AI文件系统MCP v2.0🚀

AI优化的模型上下文协议（MCP）服务器，用于智能文件系统操作，有10项重大改进！

🆕 v2.0中的新增功能

1. 性能改进 ⚡

智能缓存：具有基于文件大小的动态TTL的LRU缓存
并行处理：用于批量操作的工作线程
流API：高效处理大文件

2. 高级差异与比较 🔍

智能差异：比较统一、并排或内联格式的文件
三向合并：智能冲突解决
文件比较：二进制比较与哈希验证

3. 压缩和归档管理 📦

多种格式：拉链，柏油，柏油。GZ支持
批量压缩：压缩多个文件/目录
智能提取：自动检测存档格式

4. 增强的搜索功能 🔎

基于日期的搜索：按创建/修改日期查找文件
基于大小的搜索：按大小范围搜索文件
模糊搜索：查找名称相似的文件
语义搜索：自然语言文件搜索

5. 代码质量和重构 🛠️

重构建议：AI驱动的代码改进
自动格式化：项目范围的代码格式
代码质量度量：复杂性、可维护性得分
副本检测：查找并删除重复代码

6. 安全功能 🔐

文件加密：带密码的AES-256加密
秘密扫描：检测硬编码凭据
安全审计：综合安全报告
权限管理：安全权限更改
壳牌执行：通过验证确保命令执行的安全性（新增！）

7. 批量操作 📋

批量加工：批量重命名、移动、复制、删除
模式匹配：基于文件模式的操作
事务支持：原子多文件操作
进度跟踪：实时操作进度

8. 集成与同步 🔗

云存储：S3，地面军事系统同步
多VCS支持：Git、SVN、Mercurial
自动提交规则：基于模式的自动提交
远程FS安装：SSHFS、NFS、SMB支持

9. 监控和分析 📊

性能指标：操作时间和统计
误差分析：详细的错误模式和恢复
系统统计信息：磁盘使用情况、I/O监控
操作历史记录：完整的审计跟踪

10. 增强的错误处理 🚨

智能恢复：自动错误恢复建议
你是说：文件路径建议
权限提示：许可问题的解决方案
详细背景：丰富的错误信息

🎯 语言特定功能（v2.2中的新功能！）

增强的代码分析🔬

该系统现在为多种编程语言提供深度语言特定分析：

python 🐍

装饰器：使用参数分析函数/类装饰器
数据类：从中提取字段和类型 @dataclass
枚举：解析枚举类及其值
类型提示：完全支持Python类型注释

Java ☕

注释：解析所有带参数的Java注释
接口：提取接口方法和属性
枚举：使用构造函数分析枚举类型

去 🚹

接口：解析Go接口及其方法签名
结构标签：分析结构体字段标记
嵌入式类型：手柄界面组成

锈 🦀

特质：相关类型的全面特征分析
宏：检测宏定义并对其进行分类
枚举：解析带有变体的复杂枚举

迅速的 🦉

协议：分析协议要求
扩展：轨道类型扩展及其方法
枚举：解析具有关联值和原始类型的枚举
泛型：提取通用参数和约束

科特林 🎯

数据类：分析具有类型的数据类字段
密封类：跟踪密封类层次结构
注释：完全注释支持
接口：分析接口方法和属性

斯卡拉 🔧

特质：分析性状和混合物
案例类别：解析案例类参数
密封特性：跟踪ADT层次结构

灵药 💧

行为：解析行为回调
协议：分析协议定义
宏：检测宏定义

代码修改支持📝

超越JavaScript/TypeScript的扩展代码修改功能：

支持的修改语言:

✅ JavaScript/TypeScript：完全基于AST的修改
✅ python：基于文本的智能修改
✅ Java：基于智能模式的更新
✅ 去：结构感知修改
✅ 锈：安全的代码转换
✅ 迅速的：面向协议的更新
✅ 科特林：空安全修改

修改类型:

符号重命名：重命名函数、类、变量
进口管理：智能添加/删除导入
功能更新：替换或添加功能
物业添加：添加类/结构体属性
图案替换：基于正则表达式的高级更新

核心功能（增强型）

智能文件操作

缓存阅读：使用智能缓存读取文件
安全写作：覆盖前自动备份
模式搜索：高级glob和regex模式
内容搜索：带上下文的全文搜索

代码智能

AST分析：深入理解代码结构
智能修改：安全的代码转换
相关性分析：项目依赖关系图
进口管理：自动导入优化

版本控制（v2.1.1中增强）🆕

Git仓库管理:

- git_init：初始化新存储库（常规或裸存储库） - git_clone：从URL克隆存储库

分期付款和承诺:

- git_add：阶段文件或所有更改 - git_commit：通过消息提交 - git_status：检查存储库状态

转移操作:

- git_branch：列出、创建、删除、签出分支 - git_checkout：在分支之间切换 - git_merge：合并分支机构（即将推出）

远程操作:

- git_push：推送到远程存储库 - git_pull：从远程存储库中提取 - git_remote：管理遥控器（即将推出）

历史与检查:

- git_log：查看提交历史记录 - git_diff：查看更改（即将推出）

GitHub集成:

- github_create_pr：通过GitHub CLI创建pull请求 - github_create_repo：创建GitHub存储库（即将推出） - github_list_prs：列出拉取请求（即将推出）

Git高级功能:

- git_stash：过时的变化（即将推出） - git_rebase：重新建立分支机构（即将推出） - git_tag：标签管理（即将推出）

安装

# Clone the repository
git clone https://github.com/yourusername/ai-filesystem-mcp.git
cd ai-filesystem-mcp

# Install dependencies
npm install

# Build the project
npm run build

配置

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "ai-filesystem": {
      "command": "node",
      "args": ["/path/to/ai-filesystem-mcp/dist/index.js"]
    }
  }
}

新用法示例

特定语言分析

Use analyze_code with:
- path: "src/main.py"

Returns:
{
  "imports": [...],
  "functions": [...],
  "classes": [...],
  "languageSpecific": {
    "decorators": [
      {
        "name": "dataclass",
        "target": "User",
        "parameters": []
      }
    ],
    "dataClasses": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "int"},
          {"name": "name", "type": "str"}
        ]
      }
    ]
  }
}

代码修改（多语言）

Use modify_code with:
- path: "src/user.py"
- modifications: [
    {
      "type": "rename",
      "target": "get_user",
      "newName": "fetch_user"
    },
    {
      "type": "addImport",
      "importName": "Optional",
      "importPath": "typing"
    }
  ]

智能差异

Use diff_files with:
- file1: "src/old.js"
- file2: "src/new.js"
- format: "unified"

文件压缩

Use compress_files with:
- files: ["src", "docs", "README.md"]
- outputPath: "backup.zip"
- format: "zip"

语义搜索

Use semantic_search with:
- query: "find all configuration files related to database"
- directory: "."

安全扫描

Use scan_secrets with:
- directory: "."

批量操作

Use batch_operations with:
- operations: [
    {
      op: "rename",
      files: [{from: "*.tmp", pattern: "tmp$", replacement: "bak"}]
    },
    {
      op: "move",
      files: [{from: "old/*", to: "archive/"}]
    }
  ]

代码重构

Use suggest_refactoring with:
- path: "src/index.js"

文件加密

Use encrypt_file with:
- path: "sensitive.txt"
- password: "your-secure-password"

Shell执行（增强！）🔒

完全控制 `execute_shell`:

Use execute_shell with:
- command: "npm"
- args: ["run", "build"]
- securityLevel: "moderate"  // Choose security level
- timeout: 30000
- cwd: "./project"          // Working directory
- env: {NODE_ENV: "production"} // Environment variables
- interactive: false        // Interactive mode

// Security levels:
// - "strict": Very restrictive
// - "moderate": Allows development tools (default)
// - "permissive": Minimal restrictions

快速执行 `shell` 新

Use shell with:
- cmd: "git status --short"
- cwd: "./project"  // Optional

// Examples:
- cmd: "ls -la | head -5"
- cmd: "npm run test"
- cmd: "echo Hello World"

// Always runs in permissive mode
// Perfect for quick development tasks

Git操作（新增！）

# Initialize a new repository
Use git_init with:
- path: "./my-project"

# Stage all changes
Use git_add with:
- files: "."

# Commit changes
Use git_commit with:
- message: "feat: add new feature"
- files: ["src/feature.js", "test/feature.test.js"]

# Push to remote
Use git_push with:
- remote: "origin"
- branch: "main"

# Create a pull request
Use github_create_pr with:
- title: "Add awesome feature"
- body: "This PR adds..."

# View commit history
Use git_log with:
- limit: 20

# Branch operations
Use git_branch with:
- action: "create"
- name: "feature/new-feature"

性能基准

缓存命中率：对于频繁访问的文件，高达90%
批量操作：比顺序处理快10倍
大文件处理：对大于100MB的文件进行流处理
搜索性能：索引搜索速度提高50倍

安全最佳实践

始终扫描秘密 提交代码之前
使用加密 用于敏感文件
定期安全审计 你的代码库
权限验证 系统运行前
沙盒操作 对于不受信任的路径

高级配置

缓存设置

// Customize cache behavior
const cacheOptions = {
  maxSize: 200 * 1024 * 1024, // 200MB
  ttl: 600000, // 10 minutes
  updateAgeOnGet: true
};

监控设置

// Enable real-time monitoring
const monitoringOptions = {
  logFile: './filesystem.log',
  metricsInterval: 5000,
  maxLogSize: 10000
};

支持的语言

分析支持（完整）

JavaScript/TypeScript（.js、.jsx、.ts、.tsx、.mjs、.cjs）
Python（.py、.pyw）
Java（.Java）
去（.去）
锈蚀（.rs）
Swift（.Swift）
Kotlin（.kt，.kts）
Scala（.scale）
Elixir（.ex，.exs）
Ruby（.rb）
PHP（.PHP）
C/C++（.C、.cpp、.cc、.cxx）
C#（.cs）

修改支持

JavaScript/TypeScript（基于AST）
Python（基于模式）
Java（基于模式）
Go（基于模式）
Rust（基于模式）
Swift（基于模式）
Kotlin（基于模式）

故障排除

常见问题

权限不足

- 检查文件权限 get_file_metadata - 使用 change_permissions 具有适当的值 - 运行安全审计以识别问题

大文件性能

- 为大于10MB的文件启用流媒体 - 使用压缩进行存档 - 考虑使用云同步进行备份

搜索未找到文件

- 尝试使用较低阈值进行模糊搜索 - 对自然查询使用语义搜索 - 检查文件模式和排除项

代码分析问题

- 确保文件具有适当的扩展名 - 检查代码中的语法错误 - 使用特定语言的分析器

贡献

我们欢迎捐款！重点领域：

性能优化
新的云存储集成
其他安全模式
特定语言的重构规则
更多语言分析器和修饰符

路线图🗺️

✅ 第1阶段：命令模式（完成）

将所有39个命令迁移到命令模式
删除了单片开关语句
改进了代码组织和可测试性

✅ 第2阶段：语言支持（在v2.2中完成）

为9+种语言添加了特定语言的分析器
将代码修改扩展到7种语言
深入分析语言特征

🔄 第3阶段：服务架构（规划中）

将FileSystemManager分解为10个服务
实现依赖注入
添加Zod进行运行时类型验证
统一错误处理系统

🚀 第四阶段：性能优化（未来）

基于事件的文件监视（延迟提高100倍）
大文件流处理（20倍内存效率）
用于并行操作的工作线程池（速度提高6倍）
智能缓存和内存管理

看改装.md 详细进展。

核心命令

shell命令🚀

execute_shell -执行具有多级安全控制的shell命令

- 三个安全级别：严格、中等（默认）、允许 - 完全控制执行环境 - 支持超时、环境变量、工作目录

shell -快速执行shell命令（始终允许模式）

- 简单语法：只需将完整命令作为字符串传递 - 非常适合开发任务和快速命令 - 例子： shell cmd="git status --short"

安全命令

scan_secrets -扫描目录以查找硬编码的机密
encrypt_file -使用密码加密文件
decrypt_file -解密加密文件
security_audit -对目录执行安全审计

更新日志

v2.3.2（2025-05-31）-新的Shell命令！ 🚀

🆕 新 shell 命令:

- 快速简单的shell执行 - 始终以许可模式运行 - 简单语法： shell cmd="your command" - 非常适合开发工作流程

🌟 增强 execute_shell 命令:

- 现在已正确注册为MCP命令 - 改进了错误消息和提示 - 更好的Node.js工具检测

📝 文档:

- 添加了两个shell命令的示例 - 更新核心命令部分 - 清晰的使用说明

v2.3.1（2025-05-30）-增强外壳安全！ 🔐

🎯 多级安全系统:

- 三个安全级别：严格、中等、允许 - 发展友好型“中等”水平 - 可定制的安全策略

🚀 改善开发人员体验:

- 自动Node.js工具路径检测 - 更好的带有提示的错误消息 - 开箱即用支持npm、npx、yarn、pnpm

🛡️ 智能安防:

- 上下文感知命令验证 - 开发工具白名单 - 临时许可标高

📝 文档:

- 全面的外壳安全指南 - 构建和运行指南 - 迁移说明

v2.2.0（2025-01-27）-语言智能更新！ 🧠

🎯 语言特定功能:

- 为Python、Java、Go、Rust、Swift、Kotlin、Scala、Elixir添加了分析器 - 对装饰器、注释、接口、特性、协议进行深入分析 - 支持数据类、密封类、枚举、泛型

📝 扩展代码修改:

- 代码修改现在支持JS/TS之外的7种语言 - 基于模式的智能修改 - 安全符号重命名、导入管理、功能更新

🔬 增强的代码分析:

- 特定语言特征提取 - 更好地理解代码结构 - 支持13种以上编程语言

📚 文档:

- 添加了全面的语言功能文档 - 语言特定功能的新使用示例

v2.1.1（2025-01-26）-增强Git集成！ 🔀

🎯 新增Git命令:

- Git核心操作：初始化、添加、推送、拉取、克隆 - 分支管理：创建、删除、切换、列表 - GitHub集成：创建pull请求 - 历史查看：提交日志

🔧 改进的GitIntegration类:

- 扩展了25+种新方法 - GitHub CLI集成 - 更好的错误处理

📚 文档更新:

- 添加Git命令示例 - 更新功能列表

🏗️ 项目结构改进:

- 将文件重新组织到逻辑目录中 - 清理测试结构 - 更新了package.json脚本

v2.1.0（2025-01-26）-第一阶段完成！ 🎉

✅ 第一阶段：100%完成

- 所有39个命令都迁移到命令模式 - 所有测试均通过（成功率100%） - 修复了所有边缘情况（事务、提取归档） - 添加了全面的测试套件 - 文件已完全更新

📄 主要改进：

- 事务现在使用系统临时目录（无权限问题） - 解压缩存档正确处理绝对路径 - Git命令在实际存储库中正常工作

🧪 测试覆盖范围：

- 核心部件的单元测试 - 对所有39个命令进行集成测试 - 交易的边缘案例测试

🚀 为第2阶段做好准备：服务架构分解

v2.0.0（2025-01-26）

🎉 实施了10项重大改进
⚡ 通过缓存增强性能
🔐 添加了安全功能
📊 监控和分析
🔍 高级搜索功能
📦 压缩支撑
🛠️ 代码重构工具
📋 批量操作
🔗 云集成
🚨 增强的错误处理

v1.0.0

具有核心功能的初始版本

AI FileSystem MCP

快速接入

详细介绍