MCPorter Hits 4K Stars Turning MCP Servers Into Normal Shell Commands
A TypeScript runtime plus CLI that turns any Model Context Protocol server into typed function calls, generated CLIs, or agent-ready clients.
Takeaways
- MCPorter is a TypeScript runtime and CLI for calling any MCP server as typed functions.
- Auto-discovers servers already configured in Cursor, Claude Code, Codex, Windsurf, OpenCode, and VS Code.
- Supports stdio, Streamable HTTP, and legacy SSE transports with pooled connections and auto-OAuth.
emit-tsgenerates.d.tstypes or a typed client;generate-cliships standalone Bun-compiled binaries.- Version 0.9.0 adds per-server tool filtering, sturdier stdio shutdowns, and Windows OAuth fixes.
- MIT licensed, install via
npx mcporter, Homebrew, or npm; docs at mcporter.sh.
Calling Model Context Protocol servers from anywhere except a chat client has been awkward. You either wire the server into a specific editor, hand-roll a JSON-RPC client, or write a shim that pipes stdio into your script. MCPorter is a TypeScript runtime and CLI that removes that layer, letting you invoke any MCP server as if it were a normal function, a shell command, or a generated standalone binary.
The project has climbed past 4,000 stars on GitHub, and the recent 0.9.0 release adds per-server tool filtering, sturdier stdio shutdowns, a Windows OAuth URL quoting fix, and schema-declared string coercion for tool calls. It is MIT licensed and installable through npx, Homebrew, or npm.
One runtime, every transport
MCPorter targets the case where you want the same MCP tools available from a terminal, a script, and a compiled binary. It connects to stdio, Streamable HTTP, and legacy SSE servers, negotiating the current protocol revision or falling back per server.
The zero-config story is the selling point. mcporter auto-discovers servers already configured in Cursor, Claude Code/Desktop, Codex, Windsurf, OpenCode, and VS Code, so you can inspect and call anything you have already set up in an editor without duplicating config. Try it without installing: