A Swift implementation of the GCF (Graph Compression Format) codec for encoding and decoding graph profiles and generic data structures with support for delta encoding
GCF Swift is a STDIO-only CLI tool with 5 commands. Tool definitions are inferred from command-line parsing rather than explicit MCP tool registration. No input schemas are visible in the source code, only informal descriptions. Parameter descriptions are minimal (10-30 chars). Output schemas are undocumented. No error handling guidance. This server does not implement the MCP protocol; it is a standalone CLI that reads/writes JSON via stdin/stdout. Tool definitions cannot be verified as formally registered MCP tools.
Read GCF graph from stdin, decode to JSON payload
Read GCF generic from stdin, decode to JSON
Read JSON payload from stdin, encode to GCF graph profile
Read JSON from stdin, encode to GCF generic profile
Print version
No formal MCP tool registration visible. Tool definitions are inferred from CLI command parsing, not explicit MCP tool schemas. Cannot verify tool names, descriptions, or input/output schemas are properly declared to MCP clients.
Input schemas missing or not visible for all tools. Rubric requires explicit JSON Schema with type definitions for each parameter. Only 'encode' shows partial schema structure; others have no schema.
Descriptions are too brief (10-35 chars). Rubric baseline is 194 chars average; descriptions under 20 chars score 0-20. No guidance on WHEN to use each tool or what distinguishes encode-generic from encode.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 24 | 2026-07-28+ | v2 |
Output schemas undocumented. LLMs cannot plan downstream calls or extract fields without knowing what encode/decode return. No structured response documentation.
No error handling guidance. Code calls exit(1) on invalid UTF-8 or JSON, but LLMs receive no recovery hints. Errors should guide next steps (e.g., 'Invalid JSON. Ensure input is valid JSON object with tool, tokenBudget, tokensUsed, symbols, edges fields.').