Metadata-Version: 2.4
Name: pvc-mcp-server
Version: 0.2.0
Summary: Plan Version Control (PVC) MCP Server — Git-like version control for AI agent decision tracking
Project-URL: Homepage, https://github.com/aliyun7869160768/pvc-mcp
Project-URL: Repository, https://github.com/aliyun7869160768/pvc-mcp
Project-URL: Issues, https://github.com/aliyun7869160768/pvc-mcp/issues
Author: FlyAIBox
License: Apache-2.0
License-File: LICENSE
Keywords: agent,decision-tracking,mcp,model-context-protocol,planning,version-control
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Version Control
Requires-Python: >=3.10
Requires-Dist: deepdiff>=6.0
Requires-Dist: mcp>=1.0.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Description-Content-Type: text/markdown

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Plan Version Control (PVC) MCP Server — Quick Start
=====================================================

A Git-like version control system for AI agent decision tracking.
Traditional agents remember chat content. PVC agents remember the decision
evolution process.

Installation
------------

    pip install pvc-mcp-server

CLI Usage
---------

    # Start the MCP server
    pvc-mcp

    # Or as a Python module
    python -m pvc_mcp

Claude Desktop Configuration
-----------------------------

Add to your ``claude_desktop_config.json``:

.. code-block:: json

    {
      "mcpServers": {
        "pvc": {
          "command": "python",
          "args": ["-m", "pvc_mcp"]
        }
      }
    }

Python API
----------

.. code-block:: python

    from pvc_mcp import plan_commit, plan_log, plan_diff

    # Commit a plan
    result = plan_commit(
        plan={"goal": "Build a blog system", "tasks": [...]},
        message="Initial plan"
    )

    # View history
    history = plan_log(limit=10)

    # Compare versions
    diff = plan_diff("v1", "v2")

Core Concepts
-------------

PVC is like Git for AI agent plans:

============ =========== ===========================
PVC Tool     Git Analog  Purpose
============ =========== ===========================
plan_commit  git commit  Save a plan version
plan_diff    git diff    Compare two versions
plan_checkout git checkout Restore a historical version
plan_branch  git branch  Create an experimental branch
plan_merge   git merge   Merge branches (3-way)
plan_log     git log     View decision history
plan_tag     git tag     Mark milestones
plan_stash   git stash   Temporarily shelve changes
============ =========== ===========================

Storage Structure
-----------------

::

    .plans/
    ├── HEAD                 # Current pointer
    ├── refs/heads/          # Branch references
    ├── refs/tags/           # Tag references
    ├── objects/             # Immutable plan snapshots
    └── logs/                # Operation history

License
-------

Apache 2.0 — see LICENSE file.
