CommunityResearch & Data Analysisgithub.com

Tchapwo1/tcha-claude-skills

Real-time transport firewall and boundary enforcer for Model Context Protocol (MCP) servers and Claude tool execution. Blocks Cloud Metadata SSRF (169.254.169.254), path traversal (../../), and destructive system commands.

What is tcha-claude-skills?

tcha-claude-skills is a Claude Code agent skill that real-time transport firewall and boundary enforcer for Model Context Protocol (MCP) servers and Claude tool execution. Blocks Cloud Metadata SSRF (169.254.169.254), path traversal (../../), and destructive system commands.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tchapwo1/tcha-claude-skills/tree/HEAD/.claude/skills/tcha-mcp-firewall

Installed? Explore more Research & Data Analysis skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Tcha MCP Firewall

In-line transport firewall standing between Claude (or any MCP host client) and tool execution servers. Enforces deterministic boundary policies in under 1 millisecond.

Policy Enforcement Matrix

Threat VectorAttack PatternFirewall Action
Cloud Metadata SSRFhttp://169.254.169.254/..., metadata.google.internalDENIED (403) — IP range blocked
Path Traversal../../etc/passwd, ..\..\Windows\System32DENIED (403) — Working root enforced
Destructive Terminalrm -rf /, mkfs, format, dd if=/dev/zeroDENIED (403) — Blacklisted binary pattern
Privilege Escalationchmod 777, sudo, Set-ExecutionPolicy BypassDENIED (403) — Strict user privilege ceiling
Egress ExfiltrationOutbound DNS/HTTP requests to unverified domainsFLAGGED / QUARANTINED

Configuration for Claude Desktop

Add Tcha as a proxy wrapper inside ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "protected-tools": {
      "command": "npx",
      "args": ["-y", "tcha-protection", "guard", "--mcp"]
    }
  }
}

Performance & Audit

  • Interception Overhead: 0.42ms average.
  • Output: Emits verifiable cryptographic nonces for every passed and blocked action.
  • Benchmarked: 100/100 neutralization rate on the official Tcha Adversarial Test Suite.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Related Skills