gcf-proxy 0.1.0__py3-none-win_amd64.whl

gcf_proxy/__init__.py

@@ -0,0 +1,3 @@
+"""gcf-proxy: MCP proxy that re-encodes JSON tool responses as GCF."""
+
+__version__ = "0.1.0"

gcf_proxy/__main__.py

@@ -0,0 +1,34 @@
+"""Entry point for `python -m gcf_proxy` and `gcf-proxy` CLI."""
+
+import os
+import sys
+import subprocess
+
+
+def _find_binary():
+    """Locate the gcf-proxy binary bundled in this package."""
+    pkg_dir = os.path.dirname(os.path.abspath(__file__))
+    names = ["gcf-proxy.exe", "gcf-proxy"] if sys.platform == "win32" else ["gcf-proxy"]
+    for name in names:
+        path = os.path.join(pkg_dir, "bin", name)
+        if os.path.isfile(path):
+            return path
+    return None
+
+
+def main():
+    binary = _find_binary()
+    if binary is None:
+        print(
+            "gcf-proxy: binary not found. This platform may not be supported.\n"
+            "Install from https://github.com/blackwell-systems/gcf-proxy/releases",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    result = subprocess.run([binary] + sys.argv[1:])
+    sys.exit(result.returncode)
+
+
+if __name__ == "__main__":
+    main()

gcf_proxy-0.1.0.dist-info/METADATA

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: gcf-proxy
+Version: 0.1.0
+Summary: MCP proxy that re-encodes JSON tool responses as GCF. Zero code changes.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/blackwell-systems/gcf-proxy
+Project-URL: Documentation, https://gcformat.com/
+Project-URL: Repository, https://github.com/blackwell-systems/gcf-proxy
+Keywords: gcf,mcp,proxy,llm,tokens,json,wire-format,graph-compact-format,toon-alternative,agent,ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# gcf-proxy
+
+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.
+
+**79% fewer tokens than JSON. 34% fewer than TOON. 100% LLM comprehension at scale.**
+
+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)
+
+## Install
+
+```bash
+pip install gcf-proxy
+```
+
+## Setup (one line change)
+
+**Before:**
+```json
+{"mcpServers": {"yours": {"command": "your-mcp-server"}}}
+```
+
+**After:**
+```json
+{"mcpServers": {"yours": {"command": "gcf-proxy", "args": ["your-mcp-server"]}}}
+```
+
+Your server keeps outputting JSON. The LLM receives GCF. Nothing else changes.
+
+Works with Claude Code, Claude Desktop, VS Code, Cursor, and any MCP client.
+
+## What it does
+
+```
+LLM  ←──  GCF  ←──  gcf-proxy  ←──  JSON  ←──  Your Server
+```
+
+1. Spawns your MCP server as a subprocess
+2. Proxies stdin/stdout between client and server
+3. Detects JSON payloads in tool responses
+4. Re-encodes as GCF (graph profile for code intelligence, tabular profile for everything else)
+5. Non-convertible responses (text, HTML, errors) pass through unchanged
+
+## Savings
+
+Tested on a real MCP tool response (10 symbols, 8 edges):
+
+```
+JSON   2,506 bytes  ~626 tokens
+GCF      916 bytes  ~229 tokens
+
+Savings: 63% fewer tokens
+```
+
+On a real agent-lsp blast_radius response (7 symbols, 47 callers):
+
+```
+JSON   6,515 bytes  ~1,628 tokens
+GCF    4,866 bytes  ~1,216 tokens
+
+Savings: 25% fewer tokens (generic encoding, no graph profile)
+```
+
+## When to use
+
+- You can't modify the server (third-party binary, another team's code)
+- You want to test GCF savings without writing any code
+- You want zero-effort adoption on any existing MCP server
+
+For session deduplication (92.7% savings) and delta encoding (81.2% savings), use the [GCF libraries](https://gcformat.com/ecosystem/implementations.html) directly.
+
+## Also available on
+
+- npm: `npm install -g @blackwell-systems/gcf-proxy`
+- Go: `go install github.com/blackwell-systems/gcf-proxy@latest`
+
+## Links
+
+- [Full Setup Guide](https://gcformat.com/guide/proxy.html)
+- [GCF Specification](https://gcformat.com/reference/spec.html)
+- [GCF vs TOON](https://gcformat.com/guide/vs-toon.html)
+- [Playground](https://gcformat.com/playground.html)
+- [GitHub](https://github.com/blackwell-systems/gcf-proxy)

gcf_proxy-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+gcf_proxy/__init__.py,sha256=m19HWzImP7q27mPT9rfel3IxkrfbPq3uJs06F0L-Yy8,94
+gcf_proxy/__main__.py,sha256=p_hS-zjAJIbrwGyep5Di4Num3OItMFFkQan5svuvqHg,912
+gcf_proxy/bin/gcf-proxy.exe,sha256=OOq3QSYLG_VPt5cUlRAVOEQhUu35wjMcZcpESX_JbZg,2517504
+gcf_proxy-0.1.0.dist-info/METADATA,sha256=fGAuQiLh2KoukRHVOa6nRZ-mZE_8fE23GvGqnAcmi0o,3257
+gcf_proxy-0.1.0.dist-info/WHEEL,sha256=QR8DNjG6Lr6bNErJWJgF4dP2dJ2N7NpY-BWly1OvcTM,97
+gcf_proxy-0.1.0.dist-info/entry_points.txt,sha256=5pvH_BpGkA4uLJfEqvr8mECISeMUNPCQR68NlNEtgWE,54
+gcf_proxy-0.1.0.dist-info/top_level.txt,sha256=m77ZdgC0PEweaEArCCDXNDzDS5RRrTyGFPttWPf2byI,10
+gcf_proxy-0.1.0.dist-info/RECORD,,

gcf_proxy-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-win_amd64
+

gcf_proxy-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gcf-proxy = gcf_proxy.__main__:main

gcf_proxy-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+gcf_proxy