Yokai MCP Server Template

What is Yokai MCP Server Template?

A template for building MCP (Model Context Protocol) servers using the Yokai Go framework. It provides a ready-to-extend application with the MCP server module installed, along with a dev environment, Dockerfile, and example tools.

How to use Yokai MCP Server Template?

Install by using the GitHub template or the gonew command, then run make fresh to start the development stack. The MCP server will be available at http://localhost:8080/sse.

Key features of Yokai MCP Server Template

• Ready-to-extend Yokai application with MCP server module
• Dev environment with Air for live reloading
• Production-ready Dockerfile included
• Example MCP tool and test for guidance
• Makefile for common commands (up, down, logs, test, lint)

Use cases of Yokai MCP Server Template

• Building a new MCP server in Go from a structured template
• Rapid prototyping with live reloading during development
• Creating a production-ready containerized MCP server

FAQ from Yokai MCP Server Template

What is the Yokai MCP Server Template?

It is a GitHub template based on the Yokai Go framework that provides a pre-configured project layout for building MCP servers.

How do I install it?

You can create a new repository using the GitHub template or use the gonew command with github.com/ankorstore/yokai-mcp-template as the source.

What runtime dependencies are required?

Go 1.24 is required. The dev environment uses Docker Compose, but Docker is optional for production.

How do I run the server in development?

After installation, run make fresh from the project root. This starts the Docker Compose stack with Air for live reloading. The server listens on port 8080 for SSE connections.

Is authentication or transport configured?

The template provides an MCP server over SSE at http://localhost:8080/sse; no authentication is included by default.