M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
M

Mcpc

Community
Not a standard server
A universal CLI client for MCP

This is not a typical connect-and-use MCP server; read the source repository before using it.

How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #38 of 438
Stars
★ 1.0k Very popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Node.js · Bun · Prebuilt binary
Credentials
Optional API key
License
Apache-2.0
Last commit
Tools
29
66FMRS · C

mcpc is a feature-rich MCP CLI client with comprehensive MCP support, ideal for developers and AI agents. Its security features (like OAuth and proxy) and JSON output make it excellent for scripting and automation. However, x402 and skills support are still experimental, and it lacks Roots and Sampling support. Overall, it is a powerful and flexible tool, but users should be aware of security risks and the instability of experimental features.

Strongest · Documentation 20/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
14/20
Maintenance
14/20
Documentation
20/20
Setup experience
10/20
Why each score
Reliability 8/20
This repository is a CLI client for MCP, not a typical MCP server. The initialization handshake and tool-list paths are well-described in the README, and CI workflows and a test directory provide execution evidence. However, since this is a static review with no execution, and it's a broad tool handling multiple transports, protocol versions, and auth methods, a score of 8 is justified.
Security and permissions 14/20
Project promotes security as a highlight: OAuth 2.1 support, proxy mode to mask tokens, file permissions 0600, and secure credential storage (OS keychain). It follows least privilege and requires user consent for dangerous operations. No malicious code or gross overreach detected. While destructive actions lack explicit human confirmation, CLI tools inherently expose local file system access, but this is expected.
Maintenance 14/20
Repository is actively maintained with multiple contributors, recent commits, releases via npm, CI workflows, and a test directory. License is Apache-2.0, clear and permissive. No obvious gaps found.
Documentation 20/20
Documentation is extremely thorough: installation, quickstart, detailed command reference, authentication flows, configuration, and troubleshooting sections (errors, logs). It is layered with examples, security notes, and limitations (e.g., x402 experimental, task limitations). Deserved full marks.
Setup experience 10/20
Installation via npm or Homebrew with clear instructions. As a CLI, it requires Node.js or Bun, but provides config examples for mainstream clients. Since no installation execution is verified and steps involve external dependencies, capped at 10.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesRuns commands or codeUses the network

Best for

  • Developers and AI agents who want to interact with MCP servers via CLI
  • Users who need to script MCP operations or integrate into CI/CD
  • Those who need to safely expose MCP credentials in sandboxed environments

Not for

  • Users seeking a graphical interface
  • Users needing built-in LLM calling (mcpc does not use LLMs itself)
  • Users requiring Roots or Sampling support (not supported)

Required permissions

  • Access local file system for configuration and session files
  • Network access to connect to remote MCP servers
  • OS keychain for storing credentials
  • Potential proxy access in AI sandbox scenarios

Risks and side effects

  • MCP servers may execute arbitrary commands or access local resources; ensure to use trusted servers
  • Proxy feature may expose local services; configure binding addresses carefully
  • x402 payments involve cryptocurrency transactions and financial risk
  • OAuth credentials stored in keychain; protect system security

Setup

Before you start

Runtime：Node.js · Bun · Prebuilt binary

Other optional settings (6)
MCPC_HOME_DIR optional Directory for mcpc session/profile data (default ~/.mcpc); optional.
MCPC_VERBOSE optional Set to 1/true/yes to enable verbose debug logging.
MCPC_JSON optional Set to 1/true/yes to enable JSON output by default.
HTTPS_PROXY optional Proxy URL for outbound HTTPS connections; takes precedence over HTTP_PROXY.
HTTP_PROXY optional Proxy URL for outbound HTTP connections.
NO_PROXY optional Comma-separated list of hosts excluded from proxying.

Install with Homebrew (macOS/Linux): brew install apify/tap/mcpc; or via npm globally: npm install -g @apify/mcpc (requires Node.js or Bun).

Check that it works

Run `mcpc --version` and `mcpc --help` to confirm the CLI is installed, then `mcpc connect mcp.apify.com @test` followed by `mcpc @test tools-list`; seeing the server's tool list proves the install and connection work.

Troubleshooting

  1. Check session status: run mcpc or mcpc --json to see active sessions and their states
  2. If a session is unauthorized, re-run mcpc login <server> and restart the session
  3. If a stdio server fails to start, inspect ~/.mcpc/logs/bridge-<session>.log for errors
  4. Ensure environment variables like HTTPS_PROXY or SSL_CERT_FILE are set correctly (stdio servers inherit only a minimal env)

Things to try

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

  • List all active mcpc sessions and saved auth profiles.
  • Connect to mcp.apify.com and list the available tools.
  • Search tools in the @apify session for anything matching 'search'.
  • Call the search-actors tool on @apify with keywords 'website crawler'.

Tools 29

connect writes
Connect to an MCP server and start a new named session
close writes
Close a session
restart writes
Restart a session (losing all state)
login writes
Log in to a server and save an OAuth profile
logout writes
Delete an OAuth profile for a server
clean destructive
Clean up mcpc data (sessions, profiles, logs, all)
grep read-only
Search tools and instructions across all active sessions
x402 writes
Configure an x402 payment wallet (EXPERIMENTAL)
Show 21 more tools
help read-only
Show help for a command
tools-list read-only
List all server tools
tools-get read-only
Get tool details and schema
tools-call writes
Call a tool with arguments
tasks-list read-only
List active tasks
tasks-get read-only
Check task status
tasks-result read-only
Get task result (blocks until terminal state)
tasks-cancel writes
Cancel a running task
prompts-list read-only
List available prompts
prompts-get read-only
Retrieve a prompt template
resources-list read-only
List available resources
resources-read read-only
Read a resource content
resources-subscribe writes
Subscribe to resource updates and sync to a file
resources-unsubscribe writes
Unsubscribe from resource updates
resources-templates-list read-only
List resource templates
skills-list read-only
List skills exposed by the server (experimental)
skills-get read-only
Read a skill's SKILL.md
logging-set-level writes
Set server logging level (deprecated)
ping read-only
Send a ping to check connectivity
server-discover read-only
Send server/discover request (2026-07-28 protocol)
logs read-only
View session bridge logs

Use cases

Manually inspect and debug MCP servers
Automate repeatable MCP workflows in shell scripts
Provide AI agents with full MCP protocol access
Search across sessions to enable progressive tool discovery

Supported clients

Claude DesktopPartial support
Claude CodePartial support

Listed from the project's documentation, not tested by this site.

Overview

mcpc is a command-line client for the Model Context Protocol (MCP) that maps every MCP operation to an intuitive shell command. It supports persistent sessions, stdio and Streamable HTTP transports, OAuth 2.1 authentication (with CIMD and DCR), tasks, JSON output for code mode, proxy for AI sandboxes, and experimental x402 payments. It is designed to give AI agents full MCP protocol access through a single Bash() tool call, avoiding the need to wire up dozens of MCP functions.

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 →
Compare with other MCP servers

Source revision 356f1add925a Data synced 2026-10-12 Read the FMRS scoring method