← Back to directory
M

MCPorter

Community
Framework / SDK
Carry MCP tools into scripts, CLIs, and agents

This is a framework for building MCP servers or agents, not a server you connect a client to.

Category
Dev Tools #74 of 438
Stars
★ 5.1k Very popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Node.js 24+
Credentials
No credential needed
License
MIT
Last commit
Tools
9
63FMRS · C

MCPorter is a versatile tool for calling MCP tools from scripts and CLIs, offering flexible commands and a TypeScript API. It is suitable for developers and coding agents, but requires careful handling of security and configuration.

Strongest · Maintenance 17/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
12/20
Maintenance
17/20
Documentation
16/20
Setup experience
10/20
Why each score
Reliability 8/20
The repository claims extensive support for transports and protocols and provides significant evidence of CI and tests. However, static review cannot execute code, and reliance on unverified build and test details keeps the score below 12 per calibration rules. The code appears well-organized by README, but error handling and edge cases are unverified.
Security and permissions 12/20
The tool handles OAuth and credentials, and the repository seems to have security practices, but static review cannot confirm credential storage and validation flows. No explicit confirmation for dangerous operations (like destructive deletes or remote command execution) is apparent, so no red lines are triggered. However, least privilege and data-flow disclosure details are not fully verified, hence 12.
Maintenance 17/20
The repository is active with recent commits, a clear license (MIT), and CI workflows. Maintenance appears strong, but release history and issue response are not verifiable. High stars and low open issues are positive signals but are discovery signals only.
Documentation 16/20
Documentation is extensive, with links to install guides, CLI reference, config, protocols, and troubleshooting. Documentation seems comprehensive and layered, but static review cannot verify accuracy. README provides examples, but explicit limitation disclosures are not evident.
Setup experience 10/20
Installation instructions are clear and support multiple methods (npx, brew, npm). The requirement for Node 24+ may be a limitation. Configuration example is simple, but no client-specific config examples are provided. Since static review cannot execute verification, the upper bound is 15; hence 10.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers who need to call MCP tools from scripts or CLIs
  • Developers building generated clients or CLIs
  • TypeScript and Node.js environments

Not for

  • Long-running, always-on server endpoints (not the focus)
  • Non-TypeScript or non-Node.js environments
  • Users requiring advanced authentication and permission management (needs external config)

Required permissions

  • Access to MCP servers (network or local stdio commands)
  • Read user and project configuration files based on config
  • File writes for generated artifacts (e.g., CLI generation or type emission)

Risks and side effects

  • Executing tools fetched from MCP servers can have side effects
  • Misconfiguration could accidentally connect to untrusted servers
  • Using OAuth credentials may pose security risks if not configured properly

Setup

Before you start

Runtime:Node.js 24+

Install globally via npm: npm install -g mcporter; or via Homebrew: brew install steipete/tap/mcporter. You can also try the CLI without installing using npx mcporter --version. Node 24 or newer is required.

Check that it works

Run npx mcporter --version to confirm installation, then run npx mcporter list https://mcp.context7.com/mcp --brief; printing the server's tool signatures proves the connection works.

Troubleshooting

  1. Check Node version (>=24)
  2. Verify server URL or command is correct
  3. Check config file JSONC format and path
  4. Try `mcporter list` to confirm connectivity

Things to try

Once connected, you can ask your AI assistant things like:

  • List all tools on https://mcp.context7.com/mcp
  • Call the resolve-library-id tool with query 'React hooks docs' for library react
  • Generate a standalone CLI for the context7 server's tools
  • Emit a typed TypeScript client for the context7 server

Tools 9

list read-only
List MCP servers and their tools
call read-only
Call an MCP tool and get results
resource read-only
Read an MCP resource
auth writes
Complete or seed OAuth authentication
vault read-only
Manage authentication secrets or tokens
generate-cli writes
Generate a standalone CLI for a specific server
emit-ts writes
Generate TypeScript types or clients
record writes
Record a reproducible MCP session
Show 1 more tools
replay read-only
Replay a recorded MCP session

Use cases

Quickly inspect public MCP servers and call tools from the command line
Integrate MCP tools into TypeScript scripts or runtimes
Generate standalone CLIs for specific servers
Record and replay MCP sessions for reproducible testing
Import MCP servers from other client configurations

Overview

MCPorter is a TypeScript runtime and command-line tool for discovering and calling Model Context Protocol (MCP) servers. It is for developers and coding agents that need the same MCP tools from a terminal, a script, or a generated standalone CLI. It supports stdio, Streamable HTTP, and legacy SSE servers, reads project and user config, and can import MCP servers from Cursor, Claude Code and Desktop, Codex, Windsurf, OpenCode, and VS Code. It provides commands like mcporter list, call, resource, auth, vault, generate-cli, emit-ts, record, and replay. It also offers a TypeScript runtime API such as createRuntime(), callOnce(), and createServerProxy() for tool calling in scripts.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

Source revision 627965fb6940 Data synced 2026-10-12 Read the FMRS scoring method