🎉 Join us at the kagent Community Party at KubeCon Atlanta on Nov 12
Documentation

kmcp run#

Run an MCP server on your local machine by using the Model Context Protocol inspector tool.

Note: If you do not have the MCP inspector tool installed, run npm install -g @modelcontextprotocol/inspector.

kmcp run [flags]

Flags:

  • -h, --help - Help for the command
  • --no-inspector - Run the server directly without launching the MCP inspector tool
  • --project-dir, -d - Project directory to use (default: current directory)

Global Flags:

  • --verbose, -v - Show detailed output

Example#

The following command runs the MCP server that is defined in the my-mcp-server project on your local machine. The command automatically builds the Docker image for your MCP server and opens the MCP inspector tool so that you can connect to your server.

kmcp run --project-dir my-mcp-server

To learn how to use the MCP inspector tool to connect to an MCP server, check out the FastMCP Python or MCP Go guide.

Kagent Lab: Discover kagent and kmcp
Free, on‑demand lab: build custom AI agents with kagent and integrate tools via kmcp on Kubernetes.