Code Executor MCP

One MCP to orchestrate them all. Progressive disclosure pattern - 98% token savings vs exposing all tools.

Based on Anthropic's Code Execution with MCPBuilt for Claude Code. Untested on other MCP clients.

Problem

47 MCP tools = 141k tokens just for schemas. Context exhausted before you start working.

Solution

Disable all MCPs. Enable only code-executor.

2 tools (executeTypescript, executePython) access all other MCPs on-demand:

// Claude writes this to access zen MCP
const result = await callMCPTool('mcp__zen__codereview', {...});

Result: 47 tools → 2 tools = 141k tokens → 1.6k tokens (98% reduction)

When to Use

✅ Use if:

3+ MCP servers (context bloat problem)
Mix of local + remote + APIs
Need audit logs, allowlisting, rate limiting

❌ Skip if:

1-2 MCPs (just enable them directly)
Simple filesystem/git ops (use Node.js directly)

Wrappers (Optional)

Auto-discover tool parameters from MCP schemas:

npm run generate-wrappers  # Queries MCPs, generates ~/.code-executor/wrappers/*.ts

// Before: Blind guessing
await callMCPTool('mcp__zen__thinkdeep', {...}); // What params?

// After: TypeScript-enforced parameters (auto-discovered from schema)
await thinkdeep(step, step_number, total_steps, ...)

Wrappers are auto-generated from tools/list schemas, not manually written.

Features

Executors: TypeScript (Deno), Python
Security: Sandboxed, allowlist, audit logs, rate limiting
Config: Auto-discovery, env vars, MCP integration
Quality: TypeScript, 105 tests, 90%+ coverage

Installation

# NPM
npm install -g code-executor-mcp
code-executor-mcp

# Or local dev
git clone https://github.com/aberemia24/code-executor-MCP.git
cd code-executor-mcp
npm install && npm run build
npm run server

# Docker (production)
docker-compose up -d

See DOCKER_TESTING.md for Docker security details.

Configuration

Add to .mcp.json:

{
  "mcpServers": {
    "code-executor": {
      "command": "node",
      "args": ["/path/to/code-executor-mcp/dist/index.js"],
      "env": {
        "MCP_CONFIG_PATH": "/path/to/.mcp.json"
      }
    }
  }
}

Then disable all other MCPs. Enable only code-executor.

License

MIT

Full docs: GitHub

Code Executor MCP