Makefile Usage¶

The mcpd project includes a Makefile to streamline common developer tasks.

Running make

All commands should be run from the root of the repository.

Commands¶

Environment

Most commands assume you have Go installed and available in your PATH.

Build the binary
```
make build
```
Architectures and Operating Systems

You can explicitly build the binary for a different architecture (amd64/arm64) or operating systems with:
- make build-linux
- make build-linux-arm64
Remove the compiled binary from the working directory
```
make clean
```
Install the binary to your system (typically /usr/local/bin)
```
sudo make install
```
Dependency

The install target relies on the standard build target.
Uninstall the binary
```
sudo make uninstall
```

Validate Mozilla AI registry against JSON schema
```
make validate-registry
```
When to use

Run this command before submitting PRs that modify:
- internal/provider/mozilla_ai/data/registry.json
- internal/provider/mozilla_ai/data/schema.json

Start mcpd in a container
```
make local-up
```
Default files

By default the following files will be mounted to the container:
- .mcpd.toml - the project configuration file in this repository
- ~/.config/mcpd/secrets.dev.toml - the default location for runtime configuration
Stop mcpd
```
make local-down
```

These commands manage the MkDocs developer documentation site for mcpd.

Environment

Docs commands assume you have uv installed and available in your PATH (in additon to Go).

Generate CLI reference docs from the Cobra commands
```
make docs-cli
```
Update mkdocs.yaml navigation for the CLI commands
```
make docs-nav
```
Serve the docs locally using MkDocs + uv
```
make docs-local
```
Full pipeline: generate CLI docs, update nav, serve locally
```
make docs
```
First time?

The docs-local command will create a virtual environment using uv, install MkDocs + Material theme, and start the local server at http://localhost:8000.

Here's a complete list of Makefile targets:

Target	Description
`build`	Compile the Go binary
`build-linux`	Compile the Go binary for Linux on amd64
`build-linux-arm64`	Compile the Go binary for Linux on arm64
`install`	Install binary to system path
`uninstall`	Remove installed binary
`clean`	Remove compiled binary from working directory
`test`	Run all Go tests
`validate-registry`	Validate Mozilla AI registry JSON schema
`local-up`	Start `mcpd` in a Docker container
`local-down`	Stop a running `mcpd` Docker container
`docs-cli`	Generate Markdown CLI reference docs
`docs-nav`	Update CLI doc nav in `mkdocs.yaml`
`docs-local`	Serve docs locally via `mkdocs serve`
`docs`	Alias for `docs-local` (runs everything)