article-review-mcp

Eine visuelle MCP-App zur Überprüfung expliziter Artikel-Patches mit kategorisierten Kommentaren.

Der Bearbeitungsagent übergibt dem Server kein stillschweigend umgeschriebenes Manuskript. Er übermittelt:

unchanged base document
+ explicit patches against that base
+ one or more categorized rationale comments per patch

Der Server validiert und wendet diese Patches deterministisch an, öffnet eine interaktive Review-Oberfläche, erfasst menschliche Entscheidungen und setzt den endgültigen Artikel sicher zusammen.

Warum Patch-first

Ein Volltext-Diff kann zeigen, was sich geändert hat, verliert aber die ursprüngliche Absicht des Agents. In diesem Projekt ist ein Patch das atomare Review-Objekt:

Patch
├── exact target in the original document
├── replace / delete / insert_before / insert_after
├── proposed text
├── categorized comments explaining why
└── human decision: pending / accepted / rejected / edited

Jeder Kommentar hat genau eine primäre topicId. Ein Patch kann mehrere Kommentare zu verschiedenen Themen enthalten.

Related MCP server: Lens

Aktuelle Funktionen

• Explizite PatchSet-Übermittlung gegen ein unveränderliches Basisdokument

• replace, delete, insert_before und insert_after

• SHA-256-Verifizierung der Basis

• Exakte Ankerauflösung mit optionalem contextBefore und contextAfter

• Ablehnung mehrdeutiger Anker und überlappender Patches

• Erforderliche kategorisierte Begründungskommentare für jeden Patch

• Benutzerdefinierte Themen-Taxonomien pro Review-Sitzung

• Themen-Registerkarten mit Patch-/Kommentarzahlen pro Thema

• Zwei Themen-Review-Modi:

  • alle Patches sichtbar halten und nicht verwandte Patches abblenden

  • nur Patches anzeigen, die das ausgewählte Thema enthalten

• Geteilte, einheitliche und vollständige Final-Ansichten

• Hervorhebung von Einfügungen/Löschungen auf Wortebene für Englisch und Chinesisch

• Sichtbare Patches akzeptieren, ablehnen, zurücksetzen, manuell bearbeiten und per Sammelentscheidung festlegen

• Reviewer-Kommentare hinzufügen, beantworten, auflösen und filtern

• Kompaktes, themengefiltertes Feedback für den Bearbeitungsagent

• Unveränderliche Revisionsrunden mit Übernahme von Entscheidungen zu exakten Patches

• JSON-Persistenz, optimistische Nebenläufigkeit und Idempotenz

• MCP-App plus token-geschützter localhost-Browser-Viewer

• Sichere Vorschau, Schreiben neuer Dateien, geschütztes Überschreiben und statischer HTML-Export

• Legacy-Werkzeuge base + full proposal als veraltete Kompatibilitäts-Aliasse beibehalten

Anforderungen

• Node.js 20 oder neuer

• Es ist keine Installation von Laufzeitabhängigkeiten erforderlich

Validierung

npm run check

Die Suite führt Syntaxprüfungen und 13 Tests durch, einschließlich eines echten stdio-MCP-Austauschs und localhost-Viewer-Aufrufen.

Als MCP-Server ausführen

node src/cli.mjs \
  --stdio \
  --workspace /absolute/path/to/your/writing-workspace

Beispiel-Client-Konfiguration:

{
  "mcpServers": {
    "article-review": {
      "command": "node",
      "args": [
        "/absolute/path/to/article-review-mcp/src/cli.mjs",
        "--stdio",
        "--workspace",
        "/absolute/path/to/your/writing-workspace"
      ]
    }
  }
}

Primärer Agent-Aufruf

Rufen Sie article_review_submit_patchset auf:

{
  "title": "Introduction revision",
  "format": "markdown",
  "base": {
    "type": "workspace_file",
    "path": "manuscript.md"
  },
  "baseHash": "optional-sha256-of-the-base",
  "topics": [
    {
      "id": "architecture",
      "label": "架构与叙事",
      "description": "章节组织、研究主线和段落衔接"
    },
    {
      "id": "logic",
      "label": "逻辑与论证"
    },
    {
      "id": "clarity",
      "label": "表达与清晰度"
    }
  ],
  "patchSet": {
    "id": "revision-001",
    "summary": "补齐 Section 1 到 Section 2 的理论过渡",
    "patches": [
      {
        "id": "selection-pressure-bridge",
        "operation": "replace",
        "target": {
          "oldText": "The later experiments therefore held the candidate text fixed...",
          "contextBefore": "These results support Prediction 1...",
          "contextAfter": "LLM judge reliability varies..."
        },
        "newText": "Collectively, Section 1 establishes that...",
        "comments": [
          {
            "topicId": "architecture",
            "kind": "proposal_rationale",
            "title": "补齐 Section 1 → Section 2 的逻辑桥梁",
            "body": "原文从多智能体失败直接跳到 Judge reliability，缺少为什么需要 Judge 的理论过渡。",
            "severity": "major"
          },
          {
            "topicId": "logic",
            "kind": "proposal_rationale",
            "title": "明确研究问题递进关系",
            "body": "先证明系统存在选择失败，再验证 Judge 是否能够提供可靠信号。"
          }
        ]
      }
    ]
  }
}

Patch-Regeln

• Alle Patches zielen auf dasselbe unveränderte Basisdokument.

• Jeder Patch muss mindestens einen kategorisierten Kommentar enthalten.

• Jeder Kommentar hat genau eine primäre topicId.

• target.oldText muss genau eine Stelle auflösen.

• Verwenden Sie contextBefore und contextAfter, wenn derselbe Text wiederholt vorkommt.

• Überlappende Patches und mehrere Einfügungen an einer unsicheren gemeinsamen Grenze werden abgelehnt.

• Der Server leitet den Vorschlag ab; der Agent übermittelt im primären Workflow kein zweites vollständiges Manuskript.

Typische Validierungsfehler:

BASE_HASH_MISMATCH
ANCHOR_NOT_FOUND
ANCHOR_AMBIGUOUS
PATCH_OVERLAP
MISSING_PATCH_COMMENT
UNKNOWN_COMMENT_TOPIC

Themenfokussierte Überprüfung

Die Oberfläche zeigt Themen-Registerkarten wie:

全部主题 12
架构与叙事 4
逻辑与论证 3
证据与引用 2
方法与统计 1
表达与清晰度 2

Die Auswahl eines Themas filtert die Kommentare auf der rechten Seite auf dieses Thema. Der Manuskriptbereich kann entweder:

• alle Patches behalten und nicht verwandte abblenden, oder

• nicht verwandte Patches vollständig ausblenden.

J und K navigieren nur durch die Patches, die für das aktive Thema relevant sind.

Lokaler Viewer-Fallback

Für Clients, die keine MCP-Apps rendern:

node src/cli.mjs \
  --viewer 4173 \
  --workspace /absolute/path/to/your/writing-workspace

Der Viewer bindet an 127.0.0.1 und gibt eine zufällige, token-geschützte URL aus.

Synthetische Demo:

npm run demo

Hauptwerkzeuge

Modellorientierter Workflow:

article_review_submit_patchset
article_review_open
article_review_get_feedback
article_review_add_comments
article_review_update_patchset
article_review_finalize

Nur-App-Review-Operationen:

article_review_get_page
article_review_get_document
article_review_set_patch_decision
article_review_bulk_decide
article_review_edit_patch
article_review_add_comment
article_review_reply_comment
article_review_resolve_comment

Veraltete Kompatibilitäts-Aliasse:

article_review_create
article_review_get_summary
article_review_update_proposal
article_review_set_decision
article_review_edit_hunk

Sicherheitsinvarianten

• Das Basisdokument wird Byte für Byte aus Rohsegmenten rekonstruiert.

• Das Anwenden jedes Patches rekonstruiert den abgeleiteten Vorschlag Byte für Byte.

• CRLF, Leerzeichen, Markdown, Chinesisch, Englisch und grundlegendes LaTeX werden nicht normalisiert.

• Manuskripttext wird als inerte Textknoten gerendert, niemals über innerHTML.

• Absolute Pfade, ..-Traversierung und Verzeichnis-Symlink-Escape werden abgelehnt.

• Mutationen erfordern expectedVersion und idempotencyKey.

• Das Überschreiben der Quelle erfordert eine explizite Bestätigung, eine SHA-256-Validierung der Quelle und ein Backup.

Dokumentation

• Verwendung und Workflow

• PatchSet-Protokoll

• Bearbeitungsagent-Prompt

• Implementierte Architektur

Aufgeschobener Umfang

• DOCX-Änderungsverfolgung

• PDF-Bearbeitung

• Teilweise Annahme auf Wortebene

• Echtzeit-Zusammenarbeit mehrerer Benutzer

• Google-Docs-Synchronisierung