GB

gravitykit/block-mcp

Developer tools公式

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

54 stars 5 forks 品質 75 トレンド 27NOASSERTION

WordPressブロックレベルのCRUD MCPサーバー — パスベースのミューテーション、安全ガード、設定スコアリング

概要

エージェントが実際に編集する方法のために構築されたWordPress MCPは、ページを破損することなく、複数のターンの間、一度に1ブロックです。 MCP サーバーと WordPress プラグインで、Gutenberg コンテンツを構造化されたアドレス指定可能なブロックツリーとして表示するため、エージェントはページを書き換えることなく単一の見出しを変更できます。 すべてのブロックは、兄弟のシフトを生き残る安定したgk ref UUID(他のWordPress MCPがこれを持っていない)を運ぶので、マルチターンの編集チェーンは、呼び出し間でページを再取得しません。 すべての書き込みは、ロールバック、ETag/If-Match の WordPress のリビジョンを同時オーバーライトから作成し、サーバー側のティアポリシーは、これまでヒットしたディスクからレガシーブロックを停止します。 PHP 8.2/8.3 + Node 20 の CI でバックアップし、20 の言語への翻訳。 - 周囲のHTMLに触れることなく見出しのレベルを変更します。 標準のMCPは、すべての編集にフルページを書き換えます。 MCPをブロックすると、見出しの1つだけに触れます。 - ブロックマーカーは正確に保存されます.

概要(AI 翻訳)

Block MCPは、エージェントが実際に編集する方法のために構築されたWordPress MCPです。ページを破損することなく、複数のターンの間、ブロックを一度に1ブロックします。 MCP サーバーと WordPress プラグインで、Gutenberg コンテンツを構造化されたアドレス指定可能なブロックツリーとして表示するため、エージェントはページを書き換えることなく単一の見出しを変更できます。 すべてのブロックは安定した [gk_ref] 兄弟シフトを存続する UUID (他の WordPress MCP がこれを持っていない) なので、マルチターンの編集チェーンは、呼び出し間でページを再取得しません。 すべての書き込みは、ロールバック、ETag/If-Match の WordPress のリビジョンを同時オーバーライトから作成し、サーバー側のティアポリシーは、これまでヒットしたディスクからレガシーブロックを停止します。 326 PHPテスト、249 TypeScriptテスト*、PHP 8.2/8.3 + Node 20 で CI をバックアップし、20 の言語に翻訳します。

##エージェントがブロックMCPを選ぶ理由

-ページ全体ではなく、1つのブロックを編集します。 周囲のHTMLに触れることなく見出しのレベルを変更します。 標準のMCPは、すべての編集にフルページを書き換えます。 MCPをブロックすると、見出しの1つだけに触れます。

  • Editor-safeの往復。 [ ]]ブロックマーカーは正確に保存されます。 「このブロックは、予期しないコンテンツまたは無効なコンテンツ」の警告を再開しません.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Block MCP

Block MCP is the WordPress MCP built for the way agents actually edit — one block at a time, across multiple turns, without corrupting the page. It’s an MCP server plus WordPress plugin that exposes Gutenberg content as a structured, addressable block tree instead of raw HTML, so an agent can change a single heading without rewriting the page. Every block carries a stable gk_ref UUID that survives sibling shifts (no other WordPress MCP has this), so multi-turn edit chains don’t re-fetch the page between calls. Every write creates a WordPress revision for rollback, ETag/If-Match guards against concurrent overwrites, and a server-side tier policy stops legacy blocks from ever hitting disk. Backed by 326 PHP tests, 249 TypeScript tests, CI on PHP 8.2/8.3 + Node 20, and translations to 20 languages.

Why agents pick Block MCP

  • Edits one block, not the whole page. Change a heading’s level without touching the surrounding HTML. Standard MCPs force a full page rewrite on every edit; Block MCP touches just the one heading.
  • Editor-safe round-trips. `` block markers are preserved exactly. No “this block contains unexpected or invalid content” warnings on reopen.
  • Stable block refs no other WordPress MCP has. Quickly chain inserts, deletes, and updates across turns from a single read.
  • Atomic batch edits. Fix N independent blocks in one revision with update_blocks — all-or-nothing validation, so a stale ref or out-of-range index aborts the whole batch before anything hits disk. Keeps revision history clean instead of 6 entries for one logical change.
  • Tier policy enforced server-side. Decide what blocks you want to allow or reject before they are saved, with suggested replacements.
  • Optimistic concurrency built in. Two agents working on the same post can’t silently overwrite each other.
  • Yoast SEO support built in. Read and write Yoast meta (titles, descriptions, focus keywords, canonical URLs, schema types, primary terms, Open Graph / Twitter cards) the moment Yoast SEO is active on the site.

Table of Contents

GitHub で README 全文を見る

インストール

npx -y @gravitykit/block-mcp connect --site https://example.com
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "block-mcp": { "command": "node", "args": ["/absolute/path/to/block-mcp/dist/index.cjs"], "env": { "WORDPRESS_URL": "https://example.com", "WORDPRESS_USER": "your-wp-username", "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } } } }