FileMoverMcp

FileMoverMcp

用于安全暂存并执行文件移动的工具。既可作为命令行工具使用，也可作为面向 AI Agent 的 MCP（Model Context Protocol）服务。

安装

dotnet tool install --global FileMoverMcp

dotnet tool update --global FileMoverMcp

dotnet tool uninstall --global FileMoverMcp

安装完成后，fm 命令将全局可用。

MCP 配置

要在 Claude Code 中注册为 MCP 工具：

claude mcp add filemover -- fm --mcp

对于 Cursor 或其他 MCP 客户端，请将以下内容添加到 MCP 配置中：

{
  "mcpServers": {
    "filemover": {
      "command": "fm",
      "args": ["--mcp"]
    }
  }
}

使用方法

工作流如下：初始化会话、暂存移动操作、预览，然后提交（或取消）。

fm init [path]                      # Initialize at path (default: current directory)
fm mv <source> <dest>               # Stage a file or directory move
fm mv <source> <dest> --overwrite   # Allow overwriting existing destination
fm preview                          # See all staged moves
fm commit                           # Execute all staged moves
fm cancel                           # Discard all staged moves
fm help                             # Show help information

示例

# Move files on desktop
fm init "c:/users/adam/desktop"
fm mv "old-folder/file.png" "new-folder/file.png"
fm mv "document.txt" "archive/document-backup.txt"
fm preview
fm commit

# Move an entire directory
fm init
fm mv "source-folder" "dest-folder"
fm commit

# Overwrite an existing file
fm init
fm mv "source.txt" "destination.txt" --overwrite
fm commit

行为说明

自动创建目录

如果目标路径包含尚不存在的目录，这些目录将自动创建。例如，fm mv "file.txt" "a/b/c/file.txt" 会在需要时创建 a/b/c/。

自动检测文件和目录

运行 fm mv 时，工具会检查源是文件还是目录，并进行相应处理。移动目录会保留完整的内部结构，包括嵌套子目录。

覆盖需显式启用

如果目标已存在（文件或目录），移动操作将被拒绝，除非传入 --overwrite。使用 --overwrite 时，现有目标将被完全替换。

路径受沙盒限制

所有路径均相对于会话的基础目录。尝试引用该目录之外的路径将被拒绝。

会话共享

命令行模式和 MCP 模式共享相同的会话存储，因此可以在一种模式下初始化会话，并在另一种模式下提交。

作为 MCP 服务使用

fm --mcp

作为 MCP 服务运行时，可使用以下工具：

• fm_init(path?: string) - 初始化会话
• fm_move(source: string, destination: string, overwrite: boolean) - 暂存移动操作
• fm_preview() - 预览暂存的移动操作
• fm_commit() - 执行暂存的移动操作
• fm_cancel() - 取消会话
• fm_help() - 获取帮助

开发

git clone <repository-url>
cd FileMoverMcp
dotnet build FileMoverMcp.sln
dotnet test FileMoverMcp.sln

在开发期间作为 MCP 服务运行：

dotnet run --project FileMoverMcp.Cli/FileMoverMcp.Cli.csproj -- --mcp

打包：

dotnet pack FileMoverMcp.Cli/FileMoverMcp.Cli.csproj --configuration Release

许可证

MIT 许可证