What is Nunu Layout Mcp

This project is a sample Multi-Channel Protocol (MCP) Server developed using the Nunu framework and MCP-GO, designed to provide a fast and efficient way of setting up a Golang-based MCP server. It facilitates testing and debugging through the use of the MCP Inspector tool.

Use cases

The MCP Server can be used in various contexts such as CLI tools, desktop applications, web real-time communication, web services, and embedded systems. It supports multiple transport protocols like STDIO, SSE (Server-Sent Events), and StreamableHTTP, making it versatile for different application requirements.

How to use

To use the MCP Server, first create a project by cloning the template repository or using the Nunu CLI. After navigating to the project directory, build the server with ‘go build’ and start the MCP Inspector for testing. You can then open a browser to access various transport protocols and test functionalities.

Key features

The MCP Server supports multiple communication protocols (STDIO, SSE, StreamableHTTP), is highly configurable, and includes features like logging, resource capabilities, prompt capabilities, and hooks. Developers can easily integrate clients and expand functionality.

Where to use

This MCP server is ideal for development environments where real-time communication, APIs, and service-oriented architectures are needed. It can be implemented in desktop software, web applications, and any system requiring efficient inter-process communication.

🚀 Quickly Build a High-Performance Go MCP Server

简体中文介绍

This project is a sample MCP Server built using the Nunu framework and MCP-GO. It allows you to rapidly set up a Golang-based MCP Server and test/debug it using the MCP Inspector tool.

🚀 Quick Start: Run the MCP Server in 3 Minutes

1. Create a Project

git clone https://github.com/go-nunu/nunu-layout-mcp.git
# Note: The default project name is nunu-layout-mcp

go install github.com/go-nunu/nunu@latest

nunu new mcp-demo -r https://github.com/go-nunu/nunu-layout-mcp.git

2. Build and Start

Build the MCP Server

cd mcp-demo

go build -ldflags="-s -w" -o ./bin/server ./cmd/server

Start MCP Inspector

MCP Inspector is an interactive developer tool provided by the MCP community for testing and debugging:

npx -y @modelcontextprotocol/inspector ./bin/server
# Requires Node.js to be installed

3. Test the Service

Open your browser: http://127.0.0.1:6274 to test different transport protocols.

🛠️ Development Guide

As this project is built on the Nunu architecture, it’s recommended to understand the framework before development.

📡 MCP Server Development

See the MCP-GO Server Docs

This project enables three protocols by default: STDIO, SSE, StreamableHTTP. You can modify or disable them as needed:

// File: internal/server/mcp.go

func setupSrv(logger *log.Logger) *servermcp.Server {
	mcpServer := server.NewMCPServer(
		"example-servers/everything",
		"1.0.0",
		server.WithResourceCapabilities(true, true),
		server.WithPromptCapabilities(true),
		server.WithToolCapabilities(true),
		server.WithLogging(),
		server.WithHooks(newHooks(logger)),
	)

	return servermcp.NewServer(logger,
		servermcp.WithMCPSrv(mcpServer),

		// STDIO
		servermcp.WithStdioSrv(true),

		// SSE
		servermcp.WithSSESrv(":3001", server.NewSSEServer(
			mcpServer,
			server.WithSSEEndpoint("/sse"),
		)),

		// StreamableHTTP
		servermcp.WithStreamableHTTPSrv(":3002", server.NewStreamableHTTPServer(
			mcpServer,
			server.WithEndpointPath("/mcp"),
		)),
	)
}

Call Flow Diagram

client
  ↓
internal/server/mcp.go
  ↓
internal/handler/example.go
  ↓
internal/service/example.go
  ↓
internal/repository/example.go
  ↓
DB / Third-party services

Note:

If MCP STDIO is enabled, no logs should be printed to the terminal, or the communication will break. You must configure logs to write only to a file:

# File: config/local.yml
log:
  log_level: debug
  mode: file               # file, console, or both
  encoding: console        # json or console
  log_file_name: "./storage/logs/server.log"
  max_backups: 30
  max_age: 7
  max_size: 1024
  compress: true

To view logs in Unix systems:

tail -f storage/logs/server.log

🤝 Integrating MCP Client

See MCP-GO Client Docs

You can register a client in internal/repository/repository.go, for example:

func NewStdioMCPClient() *client.Client {
	c, err := client.NewStdioMCPClient(
		"go", []string{}, "run", "/path/to/server/main.go",
	)
	if err != nil {
		panic(err)
	}
	defer c.Close()
	return c
}

To integrate other protocols or clients, follow similar patterns used in redis, gorm, etc.

📚 Resources

• Nunu Architecture
• MCP Protocol Overview
• MCP Inspector Guide
• MCP-GO Documentation

Final Notes

Currently, there is no official Golang SDK provided by the MCP organization. The most mature open-source project is mark3labs/mcp-go.

We’re looking forward to an official Golang SDK, and this project will be updated accordingly once it’s released.

Official Go MCP SDK: https://github.com/golang/tools/tree/master/internal/mcp

📄 License

Nunu is released under the MIT License — free to use and contribute!