cmcp is a command-line utility that helps you interact with MCP servers. It's basically curl for MCP servers.
pip install cmcpInteract with the STDIO server:
cmcp COMMAND METHODAdd required parameters:
cmcp COMMAND METHOD param1=value param2:='{"arg1": "value"}'Add required environment variables:
cmcp COMMAND METHOD ENV_VAR1:value ENV_VAR2:value param1=value param2:='{"arg1": "value"}'Interact with the SSE server:
cmcp URL METHODAdd required parameters:
cmcp URL METHOD param1=value param2:='{"arg1": "value"}'Add required HTTP headers:
cmcp URL METHOD Header1:value Header2:value param1=value param2:='{"arg1": "value"}'Enable verbose mode to show JSON-RPC request and response:
cmcp -v COMMAND_or_URL METHODGiven the following MCP Server (see here):
# server.py
from mcp.server.fastmcp import FastMCP
# Create an MCP server
mcp = FastMCP("Demo")
# Add a prompt
@mcp.prompt()
def review_code(code: str) -> str:
return f"Please review this code:\n\n{code}"
# Add a static config resource
@mcp.resource("config://app")
def get_config() -> str:
"""Static configuration data"""
return "App configuration here"
# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
"""Get a personalized greeting"""
return f"Hello, {name}!"
# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
"""Add two numbers"""
return a + bList prompts:
cmcp 'mcp run server.py' prompts/listGet a prompt:
cmcp 'mcp run server.py' prompts/get name=review_code arguments:='{"code": "def greet(): pass"}'List resources:
cmcp 'mcp run server.py' resources/listRead a resource:
cmcp 'mcp run server.py' resources/read uri=config://appList resource templates:
cmcp 'mcp run server.py' resources/templates/listList tools:
cmcp 'mcp run server.py' tools/listCall a tool:
cmcp 'mcp run server.py' tools/call name=add arguments:='{"a": 1, "b": 2}'Run the above MCP server with SSE transport:
mcp run server.py -t sseList prompts:
cmcp http://localhost:8000 prompts/listGet a prompt:
cmcp http://localhost:8000 prompts/get name=review_code arguments:='{"code": "def greet(): pass"}'List resources:
cmcp http://localhost:8000 resources/listRead a resource:
cmcp http://localhost:8000 resources/read uri=config://appList resource templates:
cmcp http://localhost:8000 resources/templates/listList tools:
cmcp http://localhost:8000 tools/listCall a tool:
cmcp http://localhost:8000 tools/call name=add arguments:='{"a": 1, "b": 2}'