Patchloom

Name: Patchloom
Author: patchloom

作者：patchloomバージョン 0.37.7i★ –iパソコンで動く

レジストリ名io.github.patchloom/patchloom

インストール

概要

作者による説明（英語の原文）

Agent-safe structured edits: JSON/YAML/TOML/md/AST, dry-run, batch/tx. Not a filesystem MCP.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
レジストリには、入力が必要なキーは載っていません。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "patchloom": {
      "command": "npx",
      "args": [
        "-y",
        "patchloom",
        "mcp-server"
      ]
    }
  }
}

ターミナルでこれを実行します

claude mcp add patchloom -- npx -y patchloom mcp-server

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "patchloom": {
      "command": "npx",
      "args": [
        "-y",
        "patchloom",
        "mcp-server"
      ]
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "patchloom": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "patchloom",
        "mcp-server"
      ]
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント patchloom で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32564件のうち0%よりスターが多い
このカテゴリのほかの32564件のうち96%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32564件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Patchloomは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.37.7）がレジストリに届いたのは昨日です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにRust, Node.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, Tools MCP

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211昨日更新

インストール

Tools MCP

作者：First-CH

Web production tools for AI agents: contrast, JP text, WebP, JSON-LD, slugs, dates and 40+ more

パソコンで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Patchloom

One binary. Every platform. Structured file edits for AI agents.

Patchloom is a single-binary CLI that gives AI coding agents safe, structured file editing on any operating system. It edits JSON, YAML, and TOML by selector (not regex), preserves comments, understands code structure across 20 languages, batches multiple file edits into one tool call, and works identically on Linux, macOS, and Windows.

Not a generic filesystem MCP. Default MCP filesystem servers read/write files as text. Patchloom adds dry-run previews, parser-backed config and markdown edits, AST ops, multi-file batch/tx with undo, and stable error_kind peels for hosts. Full coding agents (Claude Code, Codex, Cursor) own the loop; Patchloom is the tool layer they (or a Rust embedder) call.

# Edit a YAML value by selector without breaking comments or formatting

patchloom doc set config.yaml database.port 5432 --apply

Batch 6 file edits into a single tool call

patchloom batch --apply <<'EOF' doc.set package.json version "2.0.0" doc.set config.yaml app.version "2.0.0" doc.set config.toml project.version "2.0.0" replace README.md "1.0.0" "2.0.0" replace CHANGELOG.md "1.0.0" "2.0.0" file.create VERSION "2.0.0" EOF

Why Patchloom?

The problem

AI agents edit files through tool calls. Each call is a round-trip back to the LLM. When a task touches config files, that process has three failure modes:

Syntax corruption. The agent uses text replacement on JSON, YAML, or TOML and produces invalid output (mismatched braces, broken indentation, lost comments).
Round-trip tax. Editing 6 files means 6 separate tool calls. Each one waits for the LLM to generate, execute, read the result, and plan the next call.
Platform fragmentation. On Linux the agent uses sed, jq, grep. On Windows, none of those exist. The agent falls back to verbose PowerShell or makes errors with unfamiliar syntax.

How patchloom solves each one

Problem	How patchloom solves it
Syntax corruption	`doc` commands parse the file, change the value by selector path, and write valid output. Comments and formatting are preserved. No regex needed.
Round-trip tax	`batch` and `tx` combine N operations into 1 tool call. Six file edits become one command with atomic rollback on failure.
Platform fragmentation	Single static binary with zero dependencies. Same commands, same flags, same behavior on Linux, macOS, and Windows.

What changes with patchloom

Without patchloom (6 tool calls)

Agent: edit file 1  ─── tool call ───▶  15s

Agent: edit file 2 ─── tool call ───▶ 15s Agent: edit file 3 ─── tool call ───▶ 15s Agent: edit file 4 ─── tool call ───▶ 15s Agent: edit file 5 ─── tool call ───▶ 15s Agent: edit file 6 ─── tool call ───▶ 15s Total: ~90s

With patchloom batch (1 tool call)

Agent: batch with

all 6 edits ─── tool call ───▶ 25s

5 round-trips saved Total: ~25s

Key capabilities

Capability	What it does	Example
Parser-backed edits	Edit JSON/YAML/TOML by selector, preserving comments and formatting	`doc set config.yaml db.port 5432 --apply`
Batch N files in 1 call	`batch` and `tx` combine operations into one tool call with rollback	`batch --apply < ops.txt`
Comment preservation	YAML/TOML comments survive all edits, including array resizing	`doc append config.yaml tags '"v2"' --apply`
Heading-aware markdown	Edit sections, tables, and bullets by heading, not line number	`md table-append README.md --heading "API" --row "\	new \	row \	" --apply`
AST-aware code ops	List, rename, replace, and analyze symbols across 20 languages	`ast rename src/ --old old_name --new new_name --apply`
Atomic rollback	`strict: true` reverts every file if format or validate steps fail	`tx plan.json --apply`
MCP server	Expose all operations as structured MCP tool calls	`patchloom mcp-server`
Optional CLI sandbox	Reject `../` / absolute path escapes from `--cwd` on reads and writes (off by default; MCP always on)	`patchloom --cwd --contain search …` / `create … --apply`
Cross-platform	Identical behavior on Linux, macOS, Windows. No `sed`, `jq`, `grep` required.	Same binary everywhere

When to use patchloom vs native tools

Patchloom is not a replacement for all file operations. Its instructions tell agents exactly when to use it and when native tools are faster:

Task	Use patchloom?	Why
Edit a JSON/YAML/TOML value by selector	Yes	Parser guarantees valid output, preserves comments
Edit 3+ files in one task	Yes	`batch`/`tx` eliminates round-trips
Append a row to a markdown table	Yes	Heading-aware, no line number guessing
Read a single file	No	Native `read_file` is faster
Simple text search	No	Native `grep` is faster
Single-file text replacement	No	Native `search_replace` is faster

Correctness over speed

Patchloom is not faster than native tools for simple, single-file edits. Use native tools for those. But native text replacement cannot safely edit structured files: a sed on YAML can corrupt indentation, strip comments, or produce invalid syntax. doc set parses the file, changes the value by selector, and writes valid output. That guarantee is the point.

Where patchloom *is* faster is multi-file batching. Six file edits via native tools means six round-trips to the LLM. One batch call does the same work in a single round-trip.

Benchmark details (Claude Opus 4 via Grok Build, 11 tasks)

Task                    PL-CLI    MCP    Native

────────────────────── ────── ────── ────── search 18.5s 12.7s 13.9s ◀ ~same replace 36.1s 26.6s 26.1s ◀ ~same doc_set 30.9s 16.9s 13.7s ◀ native fastest md_table 15.5s 13.5s 15.3s ◀ MCP fastest tx_multi_file 41.4s 28.5s 22.9s ◀ native fastest batch_6_files 50.6s 46.6s 30.3s ◀ native fastest batch_mixed_ops 24.7s 13.6s 20.9s ◀ MCP fastest yaml_comment_preserve 18.1s 11.6s 16.1s ◀ MCP fastest md_insert 15.0s 11.7s 15.7s ◀ MCP fastest file_ops 26.0s 16.6s 17.2s ◀ ~same tidy 45.0s 30.3s 41.7s ◀ MCP fastest ────────────────────── ────── ────── ────── TOTAL 321.9s 228.5s 233.8s

MCP mode wins overall (228.5s vs 233.8s native) because structured tool calls skip shell syntax construction entirely. MCP wins 5/11 tasks; native wins 3/11; 3 are ties. CLI mode is always slowest due to shell construction overhead.

Install

Prefer channels that track each GitHub Release (Homebrew, Scoop, crates, npm, Releases). On Windows, Scoop is recommended. winget (Patchloom.Patchloom) is published per release and is usually current after Microsoft's publish pipeline (winget source update if search is stale). Chocolatey often lags while community moderation runs.

# Homebrew (macOS/Linux)

brew install patchloom/tap/patchloom

crates.io (requires Rust 1.95+, includes MCP server)

cargo install patchloom

npm / npx (downloads the platform binary from GitHub Releases)

npx patchloom --version

or: npm install -g patchloom

# Scoop (Windows; recommended Windows channel)

scoop bucket add patchloom https://github.com/patchloom/scoop-bucket scoop install patchloom/patchloom

Pre-built binaries for Linux, macOS, and Windows are on the Releases page. See Installation for shell installer scripts, source builds, shell completions, and winget / Chocolatey notes.

MCP Registry name: mcp-name: io.github.patchloom/patchloom

Editor extension

Install the companion extension for VS Code, Cursor, Windsurf, or VSCodium:

The extension auto-discovers the CLI (or installs it for you), generates AGENTS.md, configures MCP servers, and adds Quick Actions to the command palette. See the Editor Extension guide for details.

Quick start

1. Set up your project

patchloom init

This creates AGENTS.md in a new project or appends the rules to an existing agent instructions file, offers shell completions, and detects MCP configuration opportunities. Pass -y to skip confirmation prompts.

If you only want the rules text:

patchloom agent-rules >> AGENTS.md

Or tailor the output:

patchloom agent-rules --mode mcp >> AGENTS.md # MCP-only (no CLI examples) patchloom agent-rules --platform windows >> AGENTS.md # Windows-only syntax

If .vscode/ or .cursor/ exists, init also prints ready-to-copy .vscode/mcp.json or .cursor/mcp.json snippets.

Your AI a

冒頭だけを表示しています。続きはリポジトリで読めます

Patchloom

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

Tools MCP

作者のREADME

Patchloom

Batch 6 file edits into a single tool call

Why Patchloom?

The problem

How patchloom solves each one

What changes with patchloom

Key capabilities

When to use patchloom vs native tools

Correctness over speed

Install

crates.io (requires Rust 1.95+, includes MCP server)

npm / npx (downloads the platform binary from GitHub Releases)

or: npm install -g patchloom

Editor extension

Quick start

1. Set up your project

Or tailor the output: