Skip to content

Getting started - MCP application

Yokai provides a ready to use MCP server application template to start your MCP projects.

Overview

The MCP server application template provides:

Layout

This template is following the recommended project layout:

  • cmd/: entry points
  • configs/: configuration files
  • internal/:
    • tool/: MCP tool and test examples
    • bootstrap.go: bootstrap
    • register.go: dependencies registration

Makefile

This template provides a Makefile:

make up      # start the docker compose stack
make down    # stop the docker compose stack
make logs    # stream the docker compose stack logs
make fresh   # refresh the docker compose stack
make test    # run tests
make lint    # run linter

Installation

With GitHub

You can create your repository using the GitHub template.

It will automatically rename your project resources, this operation can take a few minutes.

Once ready, after cloning and going into your repository, simply run:

make fresh

With gonew

You can install gonew, and simply run:

gonew github.com/ankorstore/yokai-mcp-template github.com/foo/bar
cd bar
make fresh

Usage

Once ready, the application will be available on:

Going further

To go further, you can: