Hollerith-Necromancer MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Hollerith-Necromancer v2 ☠
Resurrecting Dead 1964 IBM 029 80-Column Punch-Card Decks & System/360 CP037/COMP-3 Tapes into a Zero-Dependency Forensic Ledger CLI, Stdio MCP Server & Haunted Phosphor CRT Web Workstation
Live Haunted 1964 CRT Workstation (GitHub Pages): https://jingjayhuang.github.io/kirospec-resurrection/
Hackathon: Kiroween 2026 (
kiroween.devpost.com) — Deadline2026-12-04Categories:
Resurrection(Primary Track) +Costume Contest(Bonus Spooky UI Track)Open-Source License: Apache-2.0 (
LICENSE)Zero-Float & Zero-Dependency Guarantee:
0IEEE-754 binary floats (decimal.Decimalin Python,BigIntinteger cents in JavaScript),0runtimepip/npmpackages, formula-free (<f> == 0) OpenXML.xlsxexports, and0external CDN requests.Benchmark Provenance: Bundled
data/1964_trust_deck.{bin,dck}anddata/1964_ebcdic_journal.ebcare deterministic synthetic archival test vectors (SYNTHETIC_DETERMINISTIC_FIXTURE) generated bysrc/dataset_generator.py.
1. What Dead Technology Does It Resurrect?
In 1964, financial institutions migrated accounting ledgers from IBM 029 80-column 12-row Hollerith punch cards (Rows 12, 11, 0, 1..9) onto IBM System/360 CP037 EBCDIC magnetic tapes using COBOL PIC S9(8)V99 DISPLAY trailing zoned overpunches ({, A..I = +0..+9, }, J..R = -0..-9) and PIC S9(9)V99 COMP-3 Binary-Coded Decimal (BCD) packed fields.
Modern ad-hoc conversion scripts routinely fail on archival mainframe media due to:
IEEE-754 Float Drift: Binary
floatarithmetic silently drops or invents cents across multi-hundred-voucher trial balances.Unposted Credit Overpunches: Misreading EBCDIC
'}'(0xD0,-0) or'J'..'R'(0xD1..0xD9,-1..-9) flips credit reversals into debits.Physical & Magnetic Decay: Lace-card multi-punches (
>= 6holes in one column), dropped/swapped sequence trays (Cols 73–80), and magnetic-core0xABCD nibble flips halt legacy readers.
Hollerith-Necromancer v2 cross-reconciles .bin card frames and .ebc System/360 tape records simultaneously in both Python (Decimal) and Browser/Node.js (BigInt), quarantining corruptions ("Specters") with SHA-256 frame evidence and recovering an exact $0.00-variance trial balance ($1,060,998.85 == $1,060,998.85).
Related MCP server: 4DMap
2. Kiro Feature Usage (/.kiro/ Tracked at Root)
Per official Kiroween rules, the root .kiro/ directory is tracked in Git and explicitly protected by !.kiro/ and !.kiro/** in .gitignore:
Specs (
.kiro/specs/hollerith-necromancer/):requirements.md: EARS-formatted requirements across CLI, MCP, OpenXML<f>==0export, and isomorphicBigIntbrowser binary reconciliation.design.md: Architecture diagram, bit-level IBM 029 /CP037/COMP-3layouts, and 9 formal Correctness Properties (CP-1..CP-9).tasks.md: Completed[x]engineering tasks traced directly to automated tests.
Steering (
.kiro/steering/{product,tech,structure}.md): Always-included guardrails enforcing0binary floats,0fabricated metrics,<f>==0OpenXML workbooks, and< 2 MBrepository size.Agent Hooks (
.kiro/hooks/*.json): Three automatedfileEditedhooks runningpytest,node --test, and.gitignore/ zero-float compliance gates on save.Stdio MCP Server (
.kiro/settings/mcp.json→mcp_server/hollerith_mcp.py): Exposesinspect_punch_card,decode_comp3_hex,audit_legacy_deck, andexport_clean_ledgerover JSON-RPC 2.0stdin/stdout.
3. Quick Start (CLI, Static Web UI & Automated Tests)
# 1. Generate deterministic synthetic 1964 .bin/.dck/.ebc fixtures & reconcile via CLI
PYTHONDONTWRITEBYTECODE=1 python3 -B -m src.cli generate-fixture --data-dir data
PYTHONDONTWRITEBYTECODE=1 python3 -B -m src.cli reconcile --data-dir data --outputs-dir outputs
# 2. Inspect Card #47 (lace-card tear) or dissect COMP-3 BCD hex from CLI
PYTHONDONTWRITEBYTECODE=1 python3 -B -m src.cli inspect-card --bin data/1964_trust_deck.bin --card 47
PYTHONDONTWRITEBYTECODE=1 python3 -B -m src.cli dissect-comp3 00000142550D
# 3. Open the 100% offline Haunted 1964 Phosphor CRT Workstation
open web/index.html
# 4. Run full deterministic Node + Python verification suites
node --test tests_js/hollerith_core.test.js
PYTHONDONTWRITEBYTECODE=1 python3 -B -m pytest -p no:cacheprovider -q tests/test_kiroween_v2.py4. Static Deployment (Working URL) & Submission Guide
Pushing main to a public GitHub repository publishes the root static workstation + data/ directly via GitHub Pages (https://jingjayhuang.github.io/kirospec-resurrection/). See docs/DEVPOST_SUBMISSION_PACK.md for the complete 2026-12-04 Devpost submission checklist and 3-minute demo video shotlist.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only XRP Ledger MCP tools with proof-annotation envelopes and signed daily snapshots.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Safety-first EVM and Bitcoin RPC tools for balances, contracts, blocks, and transactions
7-chain EVM audits, log simulator, wallet due diligence, calldata decoder, Chainlink & ENS.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA local-first MCP server for financial wire message forensics, providing read-only tools to parse, validate, and detect SR2026 address compliance in ISO 8583, SWIFT MT, and ISO 20022 messages.Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI clients to pin, span, join, list, and verify temporal/pattern inspection cards with fail-closed SHA-256 hashing and self-check diagnostics.361Apache 2.0
- FlicenseBqualityBmaintenanceEnables local inspection of synthetic ACH files by parsing fixed-width records, validating structure and control totals, explaining findings, masking sensitive fields, repairing derived controls, and generating deterministic test files. All work happens on-device with no bank or network transmission.10-
- AlicenseNot gradedqualityBmaintenanceEnables MCP-capable agents to query a read-only 18-SKU product registry and verified 24-track catalog, with evidence-tied lookups, momentum scoring, skin configurations, and a hash-chain-verified ledger over stdio.MIT