File Ops MCP

MCPAI代理

提供方 pierre-cheneau

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个全面的MCP服务器,通过Claude和其他LLM客户端实现安全的文件系统操作和Git版本控制。

一句话选型结论

按资料字段整理

File Ops MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 27 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量27暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

文件管理Python本地部署版本控制LLM集成Git集成自动化工具

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run src/main.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 27 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 27 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
File Ops MCP当前 27 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方pierre-cheneau上游标注的维护方 pierre-cheneau
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.6 KB
来自项目仓库与上游目录的原文,未做删改

FileOps MCP服务器

一个全面的MCP服务器,通过Claude和其他LLM客户端使用Git版本控制实现安全的文件系统操作。

概述

FileOps允许LLM:

  • 创建、读取、更新和删除文本文件
  • 创建和删除目录
  • 生成针对LLM优化的可视化文件树
  • 搜索与模式匹配的文件
  • 与Git集成的版本文件(新)
  • 所有这些都具有可配置的安全限制

特性

资源

URI模式 描述
file://{path} 访问文件内容
dir://{path} 查看目录内容
filetree://{path} 获取格式化的目录树
stats://{path} 获取详细的文件/目录统计信息
gitlog://{path} 查看Git提交历史记录(新)
gitversion://{path} 查看当前版本的文件(新)
gitversion://{path}?version={commit_id} 在特定提交时查看文件(新)
gitstatus://{path} 查看Git存储库状态(新)

工具

工具 用途 参数
read_file 读取文件内容 path:要读取的文件

start_line:可选起始行号(1-索引)
end_line:可选结束行号(1-索引)|
read_multiple_files · 一次读取多个文件 · paths:要读取的文件路径列表
create_file · 创建新的文本文件 · path:位置
content:文件内容
commit_message:自定义Git提交消息(可选)|
update_file · 更改文件中的文本 · path:目标文件
old_string:要替换的文本
new_string:替换文本
old_str:old_string的替代参数名称(LLM兼容性备份)
new_str:new_string的替代参数名称(LLM兼容性备份)
commit_message:自定义Git提交消息(可选)|
rewrite_file · 替换整个文件 · path:目标文件
content:新内容
commit_message:自定义Git提交消息(可选)|
delete_file · 删除文件 · path:要删除的文件
commit_message:自定义Git提交消息(可选)|
remove_from_file · 删除特定文本 · path:目标文件
old_string:要删除的文本
commit_message:自定义Git提交消息(可选)|
append_to_file · 在文件末尾添加文本 · path:目标文件
content:要附加的文本
commit_message:自定义Git提交消息(可选)|
insert_in_file · 在特定位置插入文本 · path:目标文件
content:要插入的文本
after_line:要插入的行号(0索引)或
before_line:要插入的行号(0索引)或
after_pattern:要插入的文本模式
commit_message:自定义Git提交消息(可选)|
copy_file · 复制文件 · path:源文件
dest_path:目标文件
commit_message:自定义Git提交消息(可选)|
move_file · 移动/重命名文件 · path:源文件
dest_path:目标文件
commit_message:自定义Git提交消息(可选)|
move_multiple_files · 移动多个文件 · source_paths:源文件路径列表
dest_paths:目标文件路径列表(如果提供,则必须与源路径长度匹配)
dest_dir:目标目录(dest_paths的替代品)
commit_message:自定义Git提交消息(可选)|
create_dir · 创建新文件夹 · path:要创建的目录
commit_message:自定义Git提交消息(可选)|
delete_dir · 删除目录 · path:要删除的目录
recursive:删除内容(可选)
commit_message:自定义Git提交消息(可选)|
get_tree · 显示文件夹结构 · path:起始目录
max_depth:树深度(可选)|
search_files · 按模式查找文件 · directory:在哪里搜索
pattern:找什么
max_results:限制结果(可选)|
find_in_files · 在文件中搜索文本 · directory:在哪里搜索
text:要查找的文本
file_pattern:文件过滤器(可选)
max_results:限制结果(可选)|
git_init · 初始化存储库 · path:在哪里创建存储库(新)
git_commit · 提交更改 · path:文件或目录
message:描述性提交消息(推荐)|
git_log · 查看提交历史记录 · path:文件路径
max_count:提交次数(新)|
git_show · 提交时查看文件 · path:文件路径
commit_id:提交引用(新)|
git_diff · 比较版本 · path:文件路径
commit1:基础承诺
commit2:比较提交(新)|
git_revert · 还原以前的版本 · path:文件路径
commit_id:目标承诺(新)|
git_status · 显示存储库状态 · path:存储库路径(新)
git_branch_list · 列出所有分支 · path:存储库路径(新)
git_branch_create · 创建新分支 · path:存储库路径
branch_name:新分支机构的名称(new)|
git_branch_switch · 切换到分支 · path:存储库路径
branch_name:目标分支(新)|

安装和设置

UV快速入门```bash

Install UV (if needed)

For macOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

For Windows PowerShell

powershell -ExecutionPolicy Bypass -Command "irm https://astral.sh/uv/install.ps1 | iex"

Clone the repository

git clone https://github.com/yourusername/fileops-mcp.git
cd fileops-mcp

Set up environment

uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate

Install dependencies

uv pip install -e .

Test in development mode

uv run src/main.py

Or run with specific options

uv run src/main.py --working-dir /path/to/dir --read-only


### pip替代品```bash
# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install from PyPI
pip install fileops-mcp

# Or install locally
pip install -e .

# Test the server
python -m src.main

Claude桌面配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Roaming\Claude\claude_desktop_config.json (Windows):```json
{
"mcpServers": {
"fileops": {
"command": "uv",
"args": [
"--directory",
"Z:/Claude/mcp-server/fileops-mcp",
"run",
"src/main.py"
],
"env": {
"WORKING_DIR": "Z:/Claude/mcp-server/fileops-mcp/working-dir",
"READ_ONLY": "false",
"GIT_ENABLED": "true",
"GIT_AUTO_COMMIT": "true"
}
}
}
}


### 使用MCP CLI进行安装

如果安装了MCP CLI,则可以使用它直接安装服务器:```bash
# Install in Claude Desktop
uv run mcp install src/main.py --name "FileOps" --env WORKING_DIR="/path/to/dir" --env GIT_ENABLED="true"

使用示例

在克劳德桌面

  • “请在~/Documents/notes.txt中创建一个包含今天笔记的新文件”
  • “显示下载文件夹中有哪些文件”
  • “阅读我的README.md文件的内容并提出改进建议”
  • “从log.txt文件中读取第10-50行以查看最近的条目”
  • “阅读package.json和tsconfig.json文件以了解项目设置”
  • 通过将“正在进行”替换为“已完成”来更新我的TODO.txt文件
  • “在Python类的构造函数后插入一个新方法”
  • “生成项目目录的文件树视图”
  • “搜索我项目中的所有Python文件”
  • “在我的项目文件中查找所有出现的'TODO'”
  • “将我的config.json文件复制到config.backup.json”
  • “将draft.txt文件移动到final/published.txt”
  • “将我的所有.log文件从temp/移动到archive/目录”
  • “在我的项目文件夹中初始化Git存储库”(新建)
  • “显示main.py的提交历史记录”(新)
  • “将当前版本的config.json与以前的版本进行比较”(新)
  • “将README.md还原为2次提交前的版本”(新)
  • “列出我的存储库中的所有分支”(新)
  • “创建一个名为“功能登录”的新分支”(新建)
  • “切换到‘开发’分支”(新)

Git集成功能

新的Git集成允许您:

  1. 跟踪更改:每次文件修改都会自动提交(可选)
  2. 历史记录:查看谁更改了什么以及何时更改
  3. 比较版本:查看文件版本之间的差异
  4. 还原以前的版本:将文件还原为早期状态
  5. 管理存储库:初始化、提交和检查状态
  6. 与分支机构合作:为不同的功能或版本创建分支
  7. 在分支之间切换:更改工作分支以隔离更改
  8. 使用自定义提交消息:添加使用标准前缀自动格式化的描述性提交消息: [operation] path: your_message

Git分支使您能够:

  • 同时处理多个功能,不受干扰
  • 创建隔离的测试环境
  • 维护文件的不同版本
  • 在发展特色分支的同时,保持主分支的稳定

默认情况下,Git操作会自动提交更改,但可以使用禁用 --disable-auto-commit.

配置选项

您可以使用以下方式配置服务器:

环境变量

  • WORKING_DIR:允许访问的目录(默认:当前目录)
  • READ_ONLY:设置为“true”以禁用所有写入操作(默认值:“false”)
  • HIDE_DOT_FILES:设置为“false”以显示隐藏文件(默认值:“true”)
  • MAX_DEPTH:目录遍历的最大深度(默认值:5,最大值:10)
  • MAX_RESULTS:搜索操作的最大结果数(默认值:100,最大值:1000)
  • GIT_ENABLED:设置为“false”以禁用Git功能(默认值:“true”)
  • GIT_AUTO_COMMIT:设置为“false”以禁用自动提交(默认值:“true”)
  • GIT_USERNAME:Git提交的用户名(默认:“FileOps MCP”)
  • GIT_EMAIL:Git提交的电子邮件(默认值:“fileops-mcp@no-reply.local")

命令行参数```bash

Run with specific options

uv run src/main.py --working-dir /path/to/dir --read-only --max-depth 3 --disable-auto-commit


### 配置文件

使用您的设置创建JSON文件:```json
{
"working_dir": "/path/to/dir",
"read_only": true,
"hide_dot_files": true,
"max_depth": 3,
"max_results": 50,
"git_enabled": true,
"git_auto_commit": false,
"git_username": "Claude User",
"git_email": "claude@example.com"
}

然后运行:```bash
uv run src/main.py --config /path/to/config.json


## 发展

欢迎投稿!要设置开发环境,请执行以下操作:```bash
# Clone the repository
git clone https://github.com/yourusername/fileops-mcp.git
cd fileops-mcp

# Create a virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

项目结构```

fileops-mcp/
└── src/
├── init.py # Package initialization
├── main.py # Entry point and CLI
├── server.py # MCP server definition
├── constants.py # Configuration constants
├── operations/
│ ├── init.py
│ ├── file_ops.py # File operations
│ ├── dir_ops.py # Directory operations
│ ├── search_ops.py # Search operations
│ ├── version_ops.py # Git operations
│ ├── help_ops.py # Help operations
│ └── help_texts.py # Help text definitions
├── utils/
│ ├── init.py
│ ├── security.py # Security utilities
│ ├── path_utils.py # Path handling utilities
│ ├── git_utils.py # Git integration utilities
│ └── formatters.py # Output formatting utilities
└── resources/
├── init.py
└── resource_handlers.py # Resource endpoint handlers
```

故障排除

  • 权限错误:确保服务器可以访问指定的目录
  • 不允许路径:检查路径是否在允许的目录内
  • 二进制文件错误:只能读取或修改文本文件
  • 文件大小限制:无法读取大于10MB的文件
  • 搜索超时:对大型目录使用更具体的模式
  • Git错误:确保安装了gitpython并且正确初始化了存储库

许可证

MIT许可证

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
File Ops MCP 怎么安装?

在客户端按下面的安装命令接入:uv run src/main.py。装完在客户端配置里引用同一个包或端点。

File Ops MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

File Ops MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

File Ops MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

File Ops MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

File Ops MCP 能提供哪些能力?

资料显示约 27 个工具;能力标签包括 版本控制、Git集成、Python、Claude、文件管理。具体工具清单以官方文档为准。

File Ops MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

File Ops MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。