tzero-mcp 0.0.0-stage → 10.7.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Toprak Ahmet Aydoğmuş
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# tzero-mcp
+
+> **Deterministic AST Context Compressor, 95% Token Reducer & 20-Tool MCP Server for Cursor, Claude Desktop, Antigravity & Copilot.**
+
+[![npm version](https://img.shields.io/npm/v/tzero-mcp.svg)](https://www.npmjs.com/package/tzero-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub Stars](https://img.shields.io/github/stars/toprakahmetaydogmus/TZeroAlgorithm?style=social)](https://github.com/toprakahmetaydogmus/TZeroAlgorithm)
+
+---
+
+### ⭐ Built by a 15-Year-Old Solo Developer
+Hi! I'm **Toprak Ahmet Aydoğmuş**, a 15-year-old developer from Siber Akademi. I created T-Zero to solve LLM token limits and eliminate AI coding hallucinations using deterministic AST analysis. If you find this package useful, **please star our repository on GitHub!**
+
+👉 **[https://github.com/toprakahmetaydogmus/TZeroAlgorithm](https://github.com/toprakahmetaydogmus/TZeroAlgorithm)**
+
+---
+
+## ⚡ Instant MCP Execution (No Install Needed)
+
+Run directly via `npx` in your `claude_desktop_config.json` or Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "tzero": {
+      "command": "npx",
+      "args": ["-y", "tzero-mcp"]
+    }
+  }
+}
+```
+
+## 🚀 CLI Installation
+
+```bash
+# Global installation
+npm install -g tzero-mcp
+
+# Compress a directory into an AST Skeleton tree (95% token savings)
+tzero --tree . --out tree.txt
+
+# Launch MCP Server
+tzero-mcp
+```
+
+## 🛠 Features
+
+- **95% Token Reduction:** Compresses source code into AST skeletons with intact function signatures and docstrings.
+- **Zero-Leak Security Guard:** Scans for hardcoded secrets before LLM context ingestion.
+- **Reality-Lock Pre-Flight:** Prevents hallucinations by verifying imports and function calls against AST.
+- **20 Native Tools:** Memory store, AST pagerank, call chain tracer, diff context, and more.
+
+## 📄 License
+
+MIT © [Toprak Ahmet Aydoğmuş](https://github.com/toprakahmetaydogmus)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/bin/tzero-mcp.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * T-Zero Model Context Protocol (MCP) Server Launcher
+ * Author: Toprak Ahmet Aydoğmuş (15-Year-Old Solo Developer @ Siber Akademi)
+ * Repository: https://github.com/toprakahmetaydogmus/TZeroAlgorithm
+ */
+
+const { spawn, execSync } = require("child_process");
+const process = require("process");
+
+// In MCP mode, banner is printed to stderr to keep stdout strictly for JSON-RPC
+const banner = `\x1b[33m
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  ⭐ T-ZERO MCP SERVER v10.7.0 (Model Context Protocol)                       │
+│                                                                              │
+│  Hi! I'm Toprak Ahmet Aydoğmuş, a 15-year-old developer from Siber Akademi. │
+│  If this tool helps you, please star:                                        │
+│  👉 https://github.com/toprakahmetaydogmus/TZeroAlgorithm                    │
+└──────────────────────────────────────────────────────────────────────────────┘
+\x1b[0m`;
+
+if (process.stderr.isTTY) {
+  process.stderr.write(banner + "\n");
+}
+
+function findPython() {
+  const candidates = ["python3", "python", "py"];
+  for (const cmd of candidates) {
+    try {
+      execSync(`${cmd} --version`, { stdio: "ignore" });
+      return cmd;
+    } catch (e) {
+      // continue
+    }
+  }
+  return null;
+}
+
+const path = require("path");
+const py = findPython();
+if (!py) {
+  console.error("\x1b[31m[ERROR] Python 3.10+ is required to run T-Zero MCP Server.\x1b[0m");
+  console.error("Please install Python from https://python.org or your package manager.");
+  process.exit(1);
+}
+
+const srcDir = path.resolve(__dirname, "..", "src");
+const scriptPath = path.join(srcDir, "tzero_mcp.py");
+
+const env = Object.assign({}, process.env, {
+  PYTHONPATH: srcDir + (process.env.PYTHONPATH ? path.delimiter + process.env.PYTHONPATH : "")
+});
+
+const args = [scriptPath, ...process.argv.slice(2)];
+const child = spawn(py, args, { stdio: "inherit", env });
+
+child.on("close", (code) => {
+  process.exit(code ?? 0);
+});
+

package/bin/tzero.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+/**
+ * T-Zero Context Architect CLI Launcher
+ * Author: Toprak Ahmet Aydoğmuş (15-Year-Old Solo Developer @ Siber Akademi)
+ * Repository: https://github.com/toprakahmetaydogmus/TZeroAlgorithm
+ */
+
+const { spawn, execSync } = require("child_process");
+const process = require("process");
+
+const banner = `\x1b[33m
+┌──────────────────────────────────────────────────────────────────────────────┐
+│  ⭐ T-ZERO CONTEXT ARCHITECT & MCP ENGINE v10.7.0                            │
+│                                                                              │
+│  Hi! I'm Toprak Ahmet Aydoğmuş, a 15-year-old developer from Siber Akademi. │
+│  I built T-Zero from scratch to eliminate token bloat and AI hallucinations. │
+│                                                                              │
+│  If this tool saves you tokens, please give us a ⭐ on GitHub:              │
+│  👉 https://github.com/toprakahmetaydogmus/TZeroAlgorithm                    │
+└──────────────────────────────────────────────────────────────────────────────┘
+\x1b[0m`;
+
+if (process.stdout.isTTY && !process.argv.includes("--json") && !process.argv.includes("--pipe")) {
+  console.log(banner);
+}
+
+function findPython() {
+  const candidates = ["python3", "python", "py"];
+  for (const cmd of candidates) {
+    try {
+      execSync(`${cmd} --version`, { stdio: "ignore" });
+      return cmd;
+    } catch (e) {
+      // continue
+    }
+  }
+  return null;
+}
+
+const path = require("path");
+const py = findPython();
+if (!py) {
+  console.error("\x1b[31m[ERROR] Python 3.10+ is required to run T-Zero.\x1b[0m");
+  console.error("Please install Python from https://python.org or your package manager.");
+  process.exit(1);
+}
+
+const srcDir = path.resolve(__dirname, "..", "src");
+const scriptPath = path.join(srcDir, "tzero_v3.py");
+
+const env = Object.assign({}, process.env, {
+  PYTHONPATH: srcDir + (process.env.PYTHONPATH ? path.delimiter + process.env.PYTHONPATH : "")
+});
+
+const args = [scriptPath, ...process.argv.slice(2)];
+const child = spawn(py, args, { stdio: "inherit", env });
+
+child.on("close", (code) => {
+  process.exit(code ?? 0);
+});
+

package/index.js

@@ -0,0 +1,16 @@
+const path = require("path");
+
+/**
+ * T-Zero Context Architect & MCP Server
+ * https://github.com/toprakahmetaydogmus/TZeroAlgorithm
+ */
+
+module.exports = {
+  version: "10.7.1",
+  author: "Toprak Ahmet Aydoğmuş (Siber Akademi)",
+  repository: "https://github.com/toprakahmetaydogmus/TZeroAlgorithm",
+  srcDir: path.resolve(__dirname, "src"),
+  mcpServer: path.resolve(__dirname, "src", "tzero_mcp.py"),
+  cli: path.resolve(__dirname, "src", "tzero_v3.py")
+};
+

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "tzero-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "10.7.1",
+  "description": "Deterministic AST Context Compressor, 95% Token Reducer & 20-Tool MCP Server for Cursor, Claude Desktop & Copilot.",
+  "main": "index.js",
+  "files": [
+    "bin",
+    "src",
+    "index.js",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "bin": {
+    "tzero": "bin/tzero.js",
+    "tzero-mcp": "bin/tzero-mcp.js"
+  },
+  "scripts": {
+    "test": "node bin/tzero.js --version"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toprakahmetaydogmus/TZeroAlgorithm.git"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "cursor",
+    "claude",
+    "claude-desktop",
+    "token-reduction",
+    "ast-pruning",
+    "context-window",
+    "ai-coding",
+    "antigravity",
+    "windsurf"
+  ],
+  "author": "Toprak Ahmet Aydoğmuş (Siber Akademi) <siberakademi@org.tr> (https://github.com/toprakahmetaydogmus)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/toprakahmetaydogmus/TZeroAlgorithm/issues"
+  },
+  "homepage": "https://github.com/toprakahmetaydogmus/TZeroAlgorithm#readme"
+}