@volute_cvc/cvc-mcp 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +65 -0
  2. package/THIRD-PARTY-NOTICES.md +4581 -10720
  3. package/package.json +2 -1
package/README.md ADDED
@@ -0,0 +1,65 @@
1
+ # @volute_cvc/cvc-mcp
2
+
3
+ Launcher for [Volute CVC](https://github.com/meirka8/volute) (Cognitive Version Control). CVC records AI-assisted development context — prompts, responses, integration-exposed reasoning, and tool metadata — alongside Git history, private by default.
4
+
5
+ This package downloads the released CVC binaries for your platform and runs them. It provides two commands:
6
+
7
+ - `cvc-mcp` — the MCP server, for coding agents that speak the Model Context Protocol.
8
+ - `cvc` — the CVC command-line interface (init, capture, sharing, and the Claude Code harness).
9
+
10
+ On first run it fetches the archive matching this package's version from the project's GitHub release, verifies it against the release `SHA256SUMS.txt`, and caches the binaries under `~/.cvc/mcp-cache/`. The checksum is an integrity check from the same origin as the archive, not an independent signature.
11
+
12
+ ## Install
13
+
14
+ Run the MCP server without installing:
15
+
16
+ ```bash
17
+ npx @volute_cvc/cvc-mcp
18
+ ```
19
+
20
+ Or install both commands on your `PATH`:
21
+
22
+ ```bash
23
+ npm install --global @volute_cvc/cvc-mcp
24
+ ```
25
+
26
+ Supported platforms: Linux x86-64, macOS x86-64, macOS ARM64, and Windows x86-64. Linux ARM64 is not published, and the launcher rejects an unsupported platform before downloading.
27
+
28
+ ## Use as an MCP server
29
+
30
+ Point your MCP client at the `cvc-mcp` command. A minimal client configuration:
31
+
32
+ ```json
33
+ {
34
+ "mcpServers": {
35
+ "cvc": { "command": "cvc-mcp", "args": [], "env": { "RUST_LOG": "info" } }
36
+ }
37
+ }
38
+ ```
39
+
40
+ The server binds to the repository or worktree at its working directory and rejects a cross-repository or sibling-worktree target. Common client locations and the exact configuration steps are in [`cvc-mcp/README.md`](https://github.com/meirka8/volute/blob/main/cvc-mcp/README.md).
41
+
42
+ ## Use the CLI
43
+
44
+ A global install also gives you `cvc`. To capture Claude Code sessions:
45
+
46
+ ```bash
47
+ cvc init
48
+ cvc privacy acknowledge-capture
49
+ cvc harness install claude-code
50
+ ```
51
+
52
+ Then start a new Claude Code session and run `cvc conversations`. See the [CLI README](https://github.com/meirka8/volute/blob/main/cvc-cli/README.md) for the full command set.
53
+
54
+ ## Privacy
55
+
56
+ Everything is private by default and fail-closed. Capture requires a one-time local acknowledgement, and remote sharing and auto-push each require a separate interactive challenge tied to the destination. No MCP client, IDE, or script can grant that consent. See [Privacy.md](https://github.com/meirka8/volute/blob/main/Privacy.md).
57
+
58
+ ## Configuration
59
+
60
+ - `CVC_RELEASE_REPOSITORY` — override the `owner/repo` the binaries are fetched from.
61
+ - `CVC_RELEASE_BASE_URL` — override the download base URL (HTTPS only).
62
+
63
+ ## License
64
+
65
+ Apache-2.0. Each published archive and this package include `THIRD-PARTY-NOTICES.md`.