快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

uv run src/main.py

详细介绍

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`：要读取的文件

安装和设置

UV快速入门

# 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替代品

# 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）：

{
  "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，则可以使用它直接安装服务器：

# 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集成允许您：

跟踪更改：每次文件修改都会自动提交（可选）
历史记录：查看谁更改了什么以及何时更改
比较版本：查看文件版本之间的差异
还原以前的版本：将文件还原为早期状态
管理存储库：初始化、提交和检查状态
与分支机构合作：为不同的功能或版本创建分支
在分支之间切换：更改工作分支以隔离更改
使用自定义提交消息：添加使用标准前缀自动格式化的描述性提交消息： [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")

命令行参数

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

配置文件

使用您的设置创建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"
}

然后运行：

uv run src/main.py --config /path/to/config.json

发展

欢迎投稿！要设置开发环境，请执行以下操作：

# 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许可证

目录标签

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

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

27

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/133a5c752d740063b555250706e1d181

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

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

File Operator (Reculi)

全面解析File OperatorMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，File Operator能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

下一个 MCP

File Ops MCP B55c355a

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