Patch File MCP

Name: Patch File MCP
Author: PyneSys

@PyneSys

代码仓库

关于 Patch File MCP

An MCP Server to patch existing files using block format

#mcp #patcher #file-operation

基本信息

分类

其他

许可证

MIT license

运行时

python

传输方式

stdio

发布者

PyneSys

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "patch-file-mcp": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Patch File MCP?

Patch File MCP is an MCP server that enables AI agents (like Claude) to make precise changes to files in projects using a block-based patch format. It provides a single tool for applying targeted edits without rewriting entire files, with built-in safety through exact text matching and uniqueness verification.

How to use Patch File MCP?

Install with uvx or from source, then configure your MCP client (e.g., Claude Desktop) by adding a "patch-file" entry in the mcpServers JSON config with the command and --allowed-dir arguments. The server starts automatically when the client uses it; no manual launch is needed. Use the patch_file tool with a file path and patch content formatted in SEARCH/REPLACE blocks.

Key features of Patch File MCP

Applies multiple search-replace blocks in a single request.
Verifies each search text appears exactly once in the file.
Restricts file operations to allowed directories only.
Provides clear error messages when a patch cannot be applied.
Designed as a safer alternative to edit_block from desktop-commander.

Use cases of Patch File MCP

An AI agent refactoring a function inside a source code file without touching other parts.
Applying a series of configuration changes to a project file in one chat turn.
Fixing a bug by replacing specific lines inside a large log or data file.
Updating documentation snippets across multiple files in a codebase.

FAQ from Patch File MCP

How does Patch File MCP differ from the `edit_block` tool?

Patch File MCP supports multiple blocks in one operation, offers stronger safety checks (exact match, uniqueness), and gives more detailed error feedback, making it a better choice for most file editing tasks.

What are the runtime requirements?

Python 3.11 or higher, the fastmcp package (version >=2.2.0, <3.0.0), and optionally uvx from the uv Python package manager for the no-install method.

Which directories can the server access?

Access is limited to directories specified via the --allowed-dir argument (can be used multiple times). Subdirectories are also allowed. If no directory is specified, only the user's home directory is accessible.

What happens if a search block doesn't match or matches multiple times?

The tool returns an error. Each search text must appear exactly once in the file for the patch to be applied; otherwise, no changes are made and a descriptive error is reported.

其他分类下的更多 MCP 服务器

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K