Getting Started

Get up and running in minutes

Version: v0.4.1 (latest release)

1

Install

Clone the repository and build the CLI:

git clone https://github.com/aawadall/mcpcli.git cd mcpcli go build -o mcpcli ./cmd/mcpcli
2

Generate

Create your MCP server project (non-interactive or interactive):

# Non-interactive (all options specified) ./mcpcli generate my-server --language golang --transport stdio --docker --examples # Interactive (missing options will prompt) ./mcpcli generate

Flags:

  • --name, -n Project name
  • --language, -l Programming language (golang, python, java, javascript/Node.js)
  • --transport, -t Transport method (stdio, rest, websocket)
  • --docker, -d Include Docker support
  • --examples, -e Include example resources and tools
  • --output, -o Output directory (default: project name)
  • --force, -f Overwrite existing directory
3

Develop

Start building your MCP server:

cd my-mcp-server go run cmd/server/main.go
4

Test

Validate your server works correctly:

# Run all tests with config file ./mcpcli test --config configs/mcp-config.json --all # Interactive mode (prompts for what to test) ./mcpcli test

Flags:

  • --config, -c Path to MCP configuration file
  • --all Test all components (resources, tools, capabilities, init)
  • --resources Test resources
  • --tools Test tools
  • --capabilities Test capabilities
  • --init Test initialization
  • --script, -f Path to test script file

Run tests with -cover and keep coverage above 85%.

Global Flags

  • --verbose, -v Enable verbose output
  • --quiet, -q Suppress output