mcporter

# mcporter Use `mcporter` to discover, call, and manage [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) servers and tools directly from the terminal. ## Prerequisites Requires Node.js: ```bash # No install needed (runs via npx) npx mcporter list # Or install globally npm install -g mcporter ``` ## Quick Start ```bash # List MCP servers already configured on this machine mcporter list # List tools for a specific server with schema details mcporter list <server> --schema # Call a tool mcporter call <server.tool> key=value ``` ## Discovering MCP Servers mcporter auto-discovers servers configured by other MCP clients (Claude Desktop, Cursor, etc.) on the machine. To find new servers to use, browse registries like [mcpfinder.dev](https://mcpfinder.dev) or [mcp.so](https://mcp.so), then connect ad-hoc: ```bash # Connect to any MCP server by URL (no config needed) mcporter list --http-url https://some-mcp-server.com --name my_server # Or run a stdio server on the fly mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs ``` ## Calling Tools ```bash # Key=value syntax mcporter call linear.list_issues team=ENG limit:5 # Function syntax mcporter call "linear.create_issue(title: \"Bug fix needed\")" # Ad-hoc HTTP server (no config needed) mcporter call https://api.example.com/mcp.fetch url=https://example.com # Ad-hoc stdio server mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com # JSON payload mcporter call <server.tool> --args '{"limit": 5}' # Machine-readable output (recommended for Gauss) mcporter call <server.tool> key=value --output json ``` ## Auth and Config ```bash # OAuth login for a server mcporter auth <server | url> [--reset] # Manage config mcporter config list mcporter config get <key> mcporter config add <server> mcporter config remove <server> mcporter config import <path> ``` Config file location: `./config/mcporter.json` (override with `--config`). ## Daemon For persistent server connections: ```bash mcporter daemon start mcporter daemon status mcporter daemon stop mcporter daemon restart ``` ## Code Generation ```bash # Generate a CLI wrapper for an MCP server mcporter generate-cli --server <name> mcporter generate-cli --command <url> # Inspect a generated CLI mcporter inspect-cli <path> [--json] # Generate TypeScript types/client mcporter emit-ts <server> --mode client mcporter emit-ts <server> --mode types ``` ## Notes - Use `--output json` for structured output that's easier to parse - Ad-hoc servers (HTTP URL or `--stdio` command) work without any config — useful for one-off calls - OAuth auth may require interactive browser flow — use `terminal(command="mcporter auth <server>", pty=true)` if needed