About Yokai MCP Server Template
Yokai MCP Server Template is a starter project for building MCP servers with the Yokai Go framework. It includes a development environment, a production Dockerfile, and example tools and tests.
Key features
- 01Preconfigured Yokai app with MCP module
- 02Air-based live-reload development setup
- 03Production-ready Dockerfile
- 04Example MCP tools and tests
- 05Makefile for development tasks
Use cases
- 01Start a Yokai-based MCP server project
- 02Use live reloading during development
- 03Run tests and linting
- 04Manage a development environment with Docker Compose
MCP support
The template includes the MCP server module and example tools; applications provide an MCP server at localhost:8080/sse.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEYokai MCP Server Template
MCP server template based on the Yokai Go framework.
Documentation
For more information about the Yokai framework, you can check its documentation.
Overview
This template provides:
- a ready to extend Yokai application, with the MCP server module installed
- a ready to use dev environment, based on Air (for live reloading)
- a ready to use Dockerfile for production
- some examples of MCP tool and test to get started
Layout
This template is following the recommended project layout:
cmd/: entry pointsconfigs/: configuration filesinternal/:tool/: MCP tool and test examplesbootstrap.go: bootstrapregister.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
Getting started
Installation
With GitHub
You can create your repository using the GitHub template.
It will automatically rename your project resources and push them, 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:
- http://localhost:8080/sse for the application MCP server
- http://localhost:8081 for the application core dashboard
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.