A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
docs: Add MCPorter runtime to MCP context bloat section
Luong NGUYENef52705f7810
diff --git a/05-mcp/README.md b/05-mcp/README.mdindex f9bc315..f361b07 100644--- a/05-mcp/README.md+++ b/05-mcp/README.md@@ -833,6 +833,60 @@ Code execution introduces its own complexity. Running agent-generated code requiThe benefits — reduced token costs, lower latency, improved tool composition — should be weighed against these implementation costs. For agents with only a few MCP servers, direct tool calls may be simpler. For agents at scale (dozens of servers, hundreds of tools), code execution is a significant improvement.+### MCPorter: A Runtime for MCP Tool Composition++[MCPorter](https://github.com/steipete/mcporter) is a TypeScript runtime and CLI toolkit that makes calling MCP servers practical without boilerplate — and helps reduce context bloat through selective tool exposure and typed wrappers.++**What it solves:** Instead of loading all tool definitions from all MCP servers upfront, MCPorter lets you discover, inspect, and call specific tools on demand — keeping your context lean.++**Key features:**++| Feature | Description |+|---------|-------------|+| **Zero-config discovery** | Auto-discovers MCP servers from Cursor, Claude, Codex, or local configs |+| **Typed tool clients** | `mcporter emit-ts` generates `.d.ts` interfaces and ready-to-run wrappers |+| **Composable API** | `createServerProxy()` exposes tools as camelCase methods with `.text()`, `.json()`, `.markdown()` helpers |+| **CLI generation** | `mcporter generate-cli` converts any MCP server into a standalone CLI with `--include-tools` / `--exclude-tools` filtering |+| **Parameter hiding** | Optional parameters stay hidden by default, reducing schema verbosity |++**Installation:**++```bash+npx mcporter list # No install required — discover servers instantly+pnpm add mcporter # Add to a project+brew install steipete/tap/mcporter # macOS via Homebrew+```++**Example — composing tools in TypeScript:**++```typescript+import { createRuntime, createServerProxy } from "mcporter";++const runtime = await createRuntime();+const gdrive = createServerProxy(runtime, "google-drive");+const salesforce = createServerProxy(runtime, "salesforce");++// Data flows between tools without passing through the model context+const doc = await gdrive.getDocument({ documentId: "abc123" });+await salesforce.updateRecord({+ objectType: "SalesMeeting",+ recordId: "00Q5f000001abcXYZ",+ data: { Notes: doc.text() }+});+```++**Example — CLI tool call:**++```bash+# Call a specific tool directly+npx mcporter call linear.create_comment issueId:ENG-123 body:'Looks good!'++# List available servers and tools+npx mcporter list+```++MCPorter complements the code-execution approach described above by providing the runtime infrastructure for calling MCP tools as typed APIs — making it straightforward to keep intermediate data out of the model context.+## Best Practices### Security Considerations@@ -1002,5 +1056,7 @@ export GITHUB_TOKEN="your_token"- [MCP Protocol Specification](https://modelcontextprotocol.io/specification)- [MCP GitHub Repository](https://github.com/modelcontextprotocol/servers)- [Available MCP Servers](https://github.com/modelcontextprotocol/servers)+- [MCPorter](https://github.com/steipete/mcporter) — TypeScript runtime & CLI for calling MCP servers without boilerplate+- [Code Execution with MCP](https://www.anthropic.com/engineering/code-execution-with-mcp) — Anthropic's engineering blog on solving context bloat- [Claude Code CLI Reference](https://code.claude.com/docs/en/cli-reference)- [Claude API Documentation](https://docs.anthropic.com)