@blackwell-systems/gcf-proxy 0.1.0 → 0.3.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.
- package/README.md +16 -2
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
MCP proxy that re-encodes JSON tool responses as [GCF](https://gcformat.com/) — the most token-efficient wire format for LLMs. Drop-in, zero code changes. A TOON/JSON alternative that saves 63-79% of tokens.
|
|
4
4
|
|
|
5
|
-
**79% fewer tokens than JSON. 34% fewer than TOON.
|
|
5
|
+
**79% fewer tokens than JSON. 34% fewer than TOON. 90.5% average comprehension accuracy across 10 models and 3 providers. 1,300+ LLM evaluations. Zero training.**
|
|
6
6
|
|
|
7
7
|
Docs: [gcformat.com](https://gcformat.com/) · [Proxy Guide](https://gcformat.com/guide/proxy.html) · [Playground](https://gcformat.com/playground.html) · [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
|
|
8
8
|
|
|
@@ -37,7 +37,7 @@ LLM ←── GCF ←── gcf-proxy ←── JSON ←── Your Serv
|
|
|
37
37
|
1. Spawns your MCP server as a subprocess
|
|
38
38
|
2. Proxies stdin/stdout between client and server
|
|
39
39
|
3. Detects JSON payloads in tool responses
|
|
40
|
-
4. Re-encodes as GCF (graph profile for code intelligence,
|
|
40
|
+
4. Re-encodes as GCF (graph profile for code intelligence, generic profile for everything else)
|
|
41
41
|
5. Non-convertible responses (text, HTML, errors) pass through unchanged
|
|
42
42
|
|
|
43
43
|
## Savings
|
|
@@ -68,6 +68,20 @@ Savings: 25% fewer tokens (generic encoding, no graph profile)
|
|
|
68
68
|
|
|
69
69
|
For session deduplication (92.7% savings) and delta encoding (81.2% savings), use the [GCF libraries](https://gcformat.com/ecosystem/implementations.html) directly.
|
|
70
70
|
|
|
71
|
+
## Benchmarks
|
|
72
|
+
|
|
73
|
+
| Format | Accuracy | Tokens | vs JSON |
|
|
74
|
+
|--------|----------|--------|---------|
|
|
75
|
+
| **GCF** | **90.5%** avg (10 models) | **11,090** | **79% fewer** |
|
|
76
|
+
| TOON | 68.5% avg | 16,378 | 69% fewer |
|
|
77
|
+
| JSON | 53.6% avg | 53,341 | baseline |
|
|
78
|
+
|
|
79
|
+
GCF wins all 6 datasets on TOON's own benchmark. 42% smaller on semi-uniform data, 34% on mixed-structure.
|
|
80
|
+
|
|
81
|
+
Reproduce comprehension eval: `git clone https://github.com/blackwell-systems/gcf-go && cd gcf-go/eval && GOWORK=off go test -run TestComprehension -v -timeout 0`
|
|
82
|
+
|
|
83
|
+
Reproduce token benchmark: `git clone https://github.com/blackwell-systems/toon && cd toon && git checkout gcf-comparison && cd benchmarks && pnpm install && pnpm benchmark:tokens`
|
|
84
|
+
|
|
71
85
|
## Also available on
|
|
72
86
|
|
|
73
87
|
- PyPI: `pip install gcf-proxy`
|
package/package.json
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@blackwell-systems/gcf-proxy",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "MCP proxy that re-encodes JSON tool responses as GCF. Zero code changes.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"gcf-proxy": "bin/gcf-proxy"
|
|
7
7
|
},
|
|
8
8
|
"optionalDependencies": {
|
|
9
|
-
"@blackwell-systems/gcf-proxy-darwin-arm64": "0.
|
|
10
|
-
"@blackwell-systems/gcf-proxy-darwin-x64": "0.
|
|
11
|
-
"@blackwell-systems/gcf-proxy-linux-arm64": "0.
|
|
12
|
-
"@blackwell-systems/gcf-proxy-linux-x64": "0.
|
|
13
|
-
"@blackwell-systems/gcf-proxy-win32-x64": "0.
|
|
14
|
-
"@blackwell-systems/gcf-proxy-win32-arm64": "0.
|
|
9
|
+
"@blackwell-systems/gcf-proxy-darwin-arm64": "0.3.0",
|
|
10
|
+
"@blackwell-systems/gcf-proxy-darwin-x64": "0.3.0",
|
|
11
|
+
"@blackwell-systems/gcf-proxy-linux-arm64": "0.3.0",
|
|
12
|
+
"@blackwell-systems/gcf-proxy-linux-x64": "0.3.0",
|
|
13
|
+
"@blackwell-systems/gcf-proxy-win32-x64": "0.3.0",
|
|
14
|
+
"@blackwell-systems/gcf-proxy-win32-arm64": "0.3.0"
|
|
15
15
|
},
|
|
16
16
|
"keywords": [
|
|
17
17
|
"gcf",
|