pvc-mcp-server 0.2.0__tar.gz

pvc_mcp_server-0.2.0/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(mkdir -p /c/PythonProject/mcp-demo/pvc_mcp)",
+      "Bash(mkdir -p /c/PythonProject/mcp-demo/examples)",
+      "Bash(python *)"
+    ]
+  }
+}

pvc_mcp_server-0.2.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,33 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyPackageRequirementsInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredPackages">
+        <value>
+          <list size="20">
+            <item index="0" class="java.lang.String" itemvalue="pynput" />
+            <item index="1" class="java.lang.String" itemvalue="opencv-python" />
+            <item index="2" class="java.lang.String" itemvalue="pyautogui" />
+            <item index="3" class="java.lang.String" itemvalue="onnxruntime-gpu" />
+            <item index="4" class="java.lang.String" itemvalue="scipy" />
+            <item index="5" class="java.lang.String" itemvalue="pydantic" />
+            <item index="6" class="java.lang.String" itemvalue="gradio" />
+            <item index="7" class="java.lang.String" itemvalue="paddleocr" />
+            <item index="8" class="java.lang.String" itemvalue="thop" />
+            <item index="9" class="java.lang.String" itemvalue="paddlepaddle-gpu" />
+            <item index="10" class="java.lang.String" itemvalue="torch" />
+            <item index="11" class="java.lang.String" itemvalue="python-multipart" />
+            <item index="12" class="java.lang.String" itemvalue="torchvision" />
+            <item index="13" class="java.lang.String" itemvalue="fastapi" />
+            <item index="14" class="java.lang.String" itemvalue="uvicorn" />
+            <item index="15" class="java.lang.String" itemvalue="torchaudio" />
+            <item index="16" class="java.lang.String" itemvalue="huggingface_hub" />
+            <item index="17" class="java.lang.String" itemvalue="steampy" />
+            <item index="18" class="java.lang.String" itemvalue="playwright" />
+            <item index="19" class="java.lang.String" itemvalue="pywebview" />
+          </list>
+        </value>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

pvc_mcp_server-0.2.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

pvc_mcp_server-0.2.0/.idea/mcp-demo.iml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module version="4">
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+</module>

pvc_mcp_server-0.2.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="mcp-demo" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="mcp-demo" project-jdk-type="Python SDK" />
+</project>

pvc_mcp_server-0.2.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/.." vcs="Git" />
+  </component>
+</project>

pvc_mcp_server-0.2.0/.idea/workspace.xml

@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="82964956-9f9b-410f-9a19-fb1328857cdf" name="更改" comment="">
+      <change beforePath="$PROJECT_DIR$/../adaptive_skip_tracker/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/../adaptive_skip_tracker/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/../adaptive_skip_tracker/README.zh-CN.md" beforeDir="false" afterPath="$PROJECT_DIR$/../adaptive_skip_tracker/README.zh-CN.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/../adaptive_skip_tracker/adaptive_tracker/lk_estimator.py" beforeDir="false" afterPath="$PROJECT_DIR$/../adaptive_skip_tracker/adaptive_tracker/lk_estimator.py" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/../adaptive_skip_tracker/adaptive_tracker/skipping_byte_tracker.py" beforeDir="false" afterPath="$PROJECT_DIR$/../adaptive_skip_tracker/adaptive_tracker/skipping_byte_tracker.py" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$/.." />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;096v&quot;
+  }
+}</component>
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/096v/adaptive_skip_tracker.git&quot;,
+    &quot;accountId&quot;: &quot;b29670df-cd03-40bf-8395-91c096fdff88&quot;
+  }
+}</component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 2
+}</component>
+  <component name="ProjectId" id="3GJ4WqDmdi1ecFCfF2jQFpVFkow" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;Python.mcp_client_deepseek.executor&quot;: &quot;Debug&quot;,
+    &quot;Python.mcp_client_langchain_chat.executor&quot;: &quot;Run&quot;,
+    &quot;Python.pvc_client_test.executor&quot;: &quot;Run&quot;,
+    &quot;Python.pvc_server.executor&quot;: &quot;Debug&quot;,
+    &quot;Python.sdkpp.executor&quot;: &quot;Run&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
+    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
+    &quot;javascript.nodejs.core.library.configured.version&quot;: &quot;22.15.0&quot;,
+    &quot;javascript.nodejs.core.library.typings.version&quot;: &quot;22.15.35&quot;,
+    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
+    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
+    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
+    &quot;nodejs_interpreter_path&quot;: &quot;node&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
+    &quot;settings.editor.selected.configurable&quot;: &quot;preferences.pluginManager&quot;,
+    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  }
+}</component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-e768b9ed790e-JavaScript-PY-243.21565.199" />
+        <option value="bundled-python-sdk-cab1f2013843-4ae2d6a61b08-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-243.21565.199" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="应用程序级" UseSingleDictionary="true" transferred="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="默认任务">
+      <changelist id="82964956-9f9b-410f-9a19-fb1328857cdf" name="更改" comment="" />
+      <created>1783676373577</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1783676373577</updated>
+      <workItem from="1783676374651" duration="1977000" />
+      <workItem from="1783680789027" duration="24721000" />
+      <workItem from="1783936919380" duration="28011000" />
+      <workItem from="1784804137567" duration="5020000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="XDebuggerManager">
+    <breakpoint-manager>
+      <default-breakpoints>
+        <breakpoint type="python-exception">
+          <properties notifyOnTerminate="true" exception="BaseException">
+            <option name="notifyOnTerminate" value="true" />
+          </properties>
+        </breakpoint>
+      </default-breakpoints>
+    </breakpoint-manager>
+    <watches-manager>
+      <configuration name="PythonConfigurationType">
+        <watch expression="__exception__[1].filename" />
+        <watch expression="__exception__[0].errno" />
+      </configuration>
+    </watches-manager>
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/mcp_demo$mcp_client_deepseek.coverage" NAME="mcp_client_deepseek 覆盖结果" MODIFIED="1783849120774" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/server" />
+    <SUITE FILE_PATH="coverage/mcp_demo$pvc_client_test.coverage" NAME="pvc_client_test 覆盖结果" MODIFIED="1784561238153" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/server" />
+    <SUITE FILE_PATH="coverage/mcp_demo$sdkpp.coverage" NAME="sdkpp 覆盖结果" MODIFIED="1784202424798" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/mcp_demo$pvc_server.coverage" NAME="pvc_server 覆盖结果" MODIFIED="1784630891248" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/server" />
+    <SUITE FILE_PATH="coverage/mcp_demo$mcp_client_langchain_chat.coverage" NAME="mcp_client_langchain_chat 覆盖结果" MODIFIED="1783848706115" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/server" />
+  </component>
+</project>

pvc_mcp_server-0.2.0/.plans/HEAD

@@ -0,0 +1 @@
+ref: refs/heads/main

pvc_mcp_server-0.2.0/.plans/logs/plan_history.log

@@ -0,0 +1,4 @@
+{"timestamp": "2026-07-22T09:05:22.873065+00:00", "action": "commit", "details": {"version": "v7d05787dfeaf98c9", "message": "Initial RAG implementation plan: Spring AI 2.0.0 + DeepSeek/Qwen + BGE-large-zh + Elasticsearch", "parent": null, "branch": "main"}}
+{"timestamp": "2026-07-22T09:05:28.694775+00:00", "action": "tag", "details": {"tag_name": "v1.0-initial-plan", "version_id": "v7d05787dfeaf98c9", "message": "初始 RAG 实施计划基线版本"}}
+{"timestamp": "2026-07-24T09:12:31.003301+00:00", "action": "commit", "details": {"version": "vf57f48345271c663", "message": "简单演示计划", "parent": "v7d05787dfeaf98c9", "branch": "main"}}
+{"timestamp": "2026-07-24T09:58:34.463107+00:00", "action": "commit", "details": {"version": "vd0457c635a9dee8b", "message": "Simple demo plan", "parent": "vf57f48345271c663", "branch": "main"}}

pvc_mcp_server-0.2.0/.plans/objects/v7d05787dfeaf98c9.json

@@ -0,0 +1,31 @@
+{
+  "version": "v7d05787dfeaf98c9",
+  "parent": null,
+  "timestamp": "2026-07-22T09:05:22.861049+00:00",
+  "message": "Initial RAG implementation plan: Spring AI 2.0.0 + DeepSeek/Qwen + BGE-large-zh + Elasticsearch",
+  "branch": "main",
+  "plan": {
+    "goal": "为电子合同 SaaS 平台构建基于 RAG 的智能客服助手系统",
+    "tasks": [
+      "阶段1: 基础设施 — 更新 pom.xml (Java 21 + Spring AI 2.0.0 BOM + 依赖), 创建 application.yml, 配置类(AiConfig/EmbeddingConfig/ESConfig), 实现 QianfanEmbeddingModel",
+      "阶段2: RAG 管道核心 — 5个管道服务(Understanding/Vectorization/Retrieval/Enhancement/Generation), RagPipelineService 编排器, ChatController + DTOs, 多轮对话 MessageChatMemoryAdvisor",
+      "阶段3: 文档与知识库 — DocumentProcessingService + ChunkingService, VectorStorageService 完整流程, QAPairGenerationService, DocumentController + KnowledgeBaseController",
+      "阶段4: 质量增强 — 意图分类(4领域), Prompt 模板系统(5个领域模板), 意图驱动模板选择+元数据过滤, 引用溯源",
+      "阶段5: 生产加固 — SSE 流式接口, Actuator 健康检查, 错误重试/降级, 单元测试+集成测试"
+    ],
+    "constraints": [
+      "Spring AI 2.0.0 必须配 Spring Boot 4.x (1.x 不兼容)",
+      "Java 升级到 21 (Spring AI 2.0.0 硬性要求)",
+      "BGE-large-zh 需自定义 QianfanEmbeddingModel (无官方 starter)",
+      "Elasticsearch 8.x 作为向量数据库",
+      "DeepSeek 为主 LLM, Qwen 为备选"
+    ],
+    "assumptions": [
+      "用户已有百度千帆 API Key/Secret Key",
+      "用户已有 DeepSeek API Key",
+      "用户已有 Qwen (DashScope) API Key",
+      "Elasticsearch 8.x 已部署或可通过 Docker 启动",
+      "帮助中心文档格式为 HTML/PDF/Markdown"
+    ]
+  }
+}

pvc_mcp_server-0.2.0/.plans/objects/vd0457c635a9dee8b.json

@@ -0,0 +1,17 @@
+{
+  "version": "vd0457c635a9dee8b",
+  "parent": "vf57f48345271c663",
+  "timestamp": "2026-07-24T09:58:34.458106+00:00",
+  "message": "Simple demo plan",
+  "branch": "main",
+  "plan": {
+    "goal": "Complete task A",
+    "tasks": [
+      "Step1",
+      "Step2",
+      "Step3"
+    ],
+    "constraints": {},
+    "assumptions": []
+  }
+}

pvc_mcp_server-0.2.0/.plans/objects/vf57f48345271c663.json

@@ -0,0 +1,17 @@
+{
+  "version": "vf57f48345271c663",
+  "parent": "v7d05787dfeaf98c9",
+  "timestamp": "2026-07-24T09:12:30.997871+00:00",
+  "message": "简单演示计划",
+  "branch": "main",
+  "plan": {
+    "goal": "完成任务 A",
+    "tasks": [
+      "步骤1",
+      "步骤2",
+      "步骤3"
+    ],
+    "constraints": {},
+    "assumptions": []
+  }
+}

pvc_mcp_server-0.2.0/.plans/refs/heads/main.json

@@ -0,0 +1,8 @@
+{
+  "current": "vd0457c635a9dee8b",
+  "versions": [
+    "v7d05787dfeaf98c9",
+    "vf57f48345271c663",
+    "vd0457c635a9dee8b"
+  ]
+}

pvc_mcp_server-0.2.0/.plans/refs/tags/v1.0-initial-plan.json

@@ -0,0 +1,5 @@
+{
+  "version": "v7d05787dfeaf98c9",
+  "message": "初始 RAG 实施计划基线版本",
+  "created_at": "2026-07-22T09:05:28.693768+00:00"
+}

pvc_mcp_server-0.2.0/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 FlyAIBox
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

pvc_mcp_server-0.2.0/PKG-INFO

@@ -0,0 +1,122 @@
+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.