DocFlow MCP：面向 AI 智能体的文档工作流管理系统

DocFlow MCP is an open-source document workflow server designed for AI agents. It enforces a complete document lifecycle (drafting → review → revision → submission) via a state machine, supports multi-model collaboration, and works with any Markdown document repository. Built on Anthropic's MCP (Model Context Protocol), it standardizes interactions between AI models and external tools, enabling compatible LLMs to handle document tasks.

As large language models advance, AI agents increasingly participate in software project documentation. However, AI-generated content requires strict review to ensure accuracy and consistency. DocFlow MCP addresses this need by providing a state machine-driven workflow system for managing the full lifecycle of agent-authored documents. It implements Anthropic's MCP protocol, abstracting document workflows into standardized tool interfaces accessible to any MCP-compatible LLM.

DocFlow MCP uses a strict state machine to manage document state transitions:

• Draft: Agents create drafts (with unique IDs, stored in SQLite for persistence).
• Review: Drafts enter review, where an AI sub-agent (via MyLLM gateway) acts as reviewer—supports different models for author and reviewer (e.g., Claude vs Gemini) for diverse perspectives.
• Revise: Unapproved drafts return to revision; the system limits iterations via DOCS_MAX_ITERATIONS to avoid loops.
• Commit/Escalate: Approved drafts are submitted to the repository; repeated failures or complex cases trigger escalation to humans.

• Model Agnosticism: Uses OpenAI-compatible gateways (default MyLLM) to interact with any supported LLM.
• Dual-Model Strategy: Recommended to use different model families for author and reviewer to avoid biases; reviewers have read-only access to code graphs/docs for objectivity.
• Flexible Repository Support: Configurable via DOCS_ROOT (document root) and DOCS_SCOPE_MAP (multi-repo mapping) to serve multiple projects.
• Prompt Version Management: Audit prompts stored in prompts/ directory (per document type); hashes link prompts to audit results for traceability.

DocFlow MCP is ideal for:

• Technical Document Maintenance: Ensures docs stay in sync with code via workflowed updates.
• ADR Management: Provides templates for Architecture Decision Records to standardize decision documentation.
• Multi-Language Docs: Leverages model language strengths for cross-language review.
• Claude Code/OpenCode Integration: Easy registration via commands to integrate into development environments.

Key environment variables:

• DOCS_ROOT: Required (document repository absolute path).
• DOCS_REVIEWER_URL: Default http://localhost:4000 (reviewer gateway).
• DOCS_REVIEWER_PROFILE: Default docs-reviewer (model profile).
• DOCS_MAX_ITERATIONS: Default 5 (max revision loops).
• DOCS_REVIEW_TIMEOUT: Default 600s (audit timeout). Deployment uses uv for Python environment management; state data stored in .docs-state (customizable via DOCS_STATE_DIR).

DocFlow MCP innovates AI-assisted document workflows by combining state machine enforcement with multi-model collaboration. It balances document quality assurance and AI automation, making it a valuable open-source solution for teams exploring AI-driven document management.