MCP server for ingesting COBOL mainframe codebases — classifies files, resolves dependencies, maps CICS transactions to REST routes
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mainframe-ingest-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# mainframe-ingest-mcp An MCP server that ingests COBOL mainframe codebases from ZIP files and produces a structured JSON manifest — ready for downstream modernization tools. ```bash pip install mainframe-ingest-mcp ``` --- ## What is this? Mainframe modernization projects always start with the same problem: **nobody knows what's in the codebase.** Thousands of COBOL files, copybooks, BMS screens, JCL jobs, and CSD exports — all sitting in a ZIP someone exported from the mainframe. `mainframe-ingest-mcp` solves the discovery step. Point it at any mainframe ZIP and it will: - Classify every file by type (COBOL, copybook, BMS screen, JCL, DB2 DDL, CSD export) - Detect and convert EBCDIC encoding to UTF-8 - Scan every COPY, EXEC SQL INCLUDE, EXEC CICS, and CALL statement - Build a full dependency graph (which programs use which copybooks) - Parse CICS transaction definitions and suggest FastAPI REST routes - Map every BMS screen to an Angular component name - Produce a single `manifest.json` — the handoff document for the rest of the pipeline It has been tested against a real 294-file, 118,000-line government CICS application and resolves 99%+ of dependencies with zero configuration. --- ## Installation ```bash pip install mainframe-ingest-mcp ``` Requires Python 3.10+. --- ## Connecting to Claude Desktop This is an MCP server — it runs locally and exposes tools to Claude Desktop. **Step 1:** Find your Claude Desktop config file: | OS | Location | |---------|----------| | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | | Windows | `%APPDATA%\Claude\claude_desktop_config.json` | | Linux | `~/.config/Claude/claude_desktop_config.json` | **Step 2:** Add this to the config: ```json { "mcpServers": { "mainframe-ingest-mcp": { "command": "mainframe-ingest-mcp" } } } ``` **Step 3:** Restart Claude Desktop. That's it. The tools will appear automatically. You can now say to Claude: > *"Extract the ZIP…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.