Golang Echo Scaffolder MCP Server

This project implements a Model Context Protocol (MCP) server in Go that exposes tools for scaffolding Echo web applications and related components. It is designed to be used as a stdio MCP server, making it compatible with a wide range of MCP clients and agentic AI workflows.

What is MCP?

The Model Context Protocol (MCP) is an open protocol that standardizes how AI applications (LLMs, agents, IDEs, etc.) connect to external tools and data sources. MCP enables composable, secure, and extensible integrations between AI models and your code, files, APIs, and more.

• Stdio MCP Server: This project uses the stdio transport, meaning it communicates over standard input/output. This is the recommended approach for local integrations and is supported by most MCP clients.

For more about MCP, see modelcontextprotocol.io or the llms.txt reference.

Features

This server exposes the following MCP tools for use by LLMs and agentic clients:

• produce_app_boilerplate: Scaffold a new Echo web application.
• produce_model_boilerplate: Generate boilerplate for a new GORM-compatible model and its repository files.
• produce_service_boilerplate: Generate boilerplate for a new service layer with DTOs (Data Transfer Objects) for a given model.
• produce_api_controller_boilerplate: Generate boilerplate for a new API controller for a given model.
• produce_html_controller_boilerplate: Generate boilerplate for a new HTML controller with views for a given model.
• fix_app: Provide pointers on common issues and how to address them in an Echo web application.

Each tool is defined with a clear input schema and returns detailed instructions or code templates for building Go web applications.

Installation

You can install this server using Go:

go install github.com/dougbarrett/mcpgo@latest

Usage

This server is intended to be launched as a stdio MCP server. It is typically started by an MCP client (such as Claude Desktop, Continue, Cursor, etc.) which will handle the process management and communication.

To run the server manually for testing:

go run main.go

Or, if installed:

mcpgo

Note: The server will wait for MCP stdio messages on stdin and write responses to stdout. It is not intended to be run as a standalone HTTP server.

Creating a User Model Application

A common use case for this tool is to create an app that has a 'user' model and model controllers. Here's how to do it:

1. Use the produce_app_boilerplate tool to scaffold a new Echo web application
2. Use the produce_model_boilerplate tool to generate boilerplate for a User model with appropriate fields
3. Use the produce_service_boilerplate tool to generate boilerplate for a service layer for the User model
4. Use the produce_api_controller_boilerplate tool to generate boilerplate for API controllers for the User model
5. (Optional) Use the produce_html_controller_boilerplate tool to generate boilerplate for HTML controllers with views for the User model

Important: mcpgo doesn't create the files for you. It provides detailed instructions and code templates that you need to implement yourself. Don't make assumptions - use what's outputted from the MCP and create the files as needed following the instructions provided.

Integrating with MCP Clients

To use this server with an MCP-compatible client:

1. Configure your client to launch the server as a stdio process (see your client's documentation for details).
2. The client will automatically discover the available tools and expose them for use in agentic workflows.

For example, in Claude Desktop, you can add this server to your configuration file as follows:

{
  "mcpServers": {
    "mcpgo": {
      "command": "mcpgo"
    }
  }
}

Supported Tools

Tool Name	Description
produce_app_boilerplate	Scaffold a new Echo web application.
produce_model_boilerplate	Generate boilerplate for a new GORM-compatible model and its repository files.
produce_service_boilerplate	Generate boilerplate for a new service layer with DTOs for a given model.
produce_api_controller_boilerplate	Generate boilerplate for a new API controller for a given model.
produce_html_controller_boilerplate	Generate boilerplate for a new HTML controller with views for a given model.
fix_app	Provide pointers on common issues in an Echo web application.

Each tool expects specific input parameters (see the code or MCP client UI for details).

About Echo and GORM

• Echo is a high performance, extensible, minimalist Go web framework.
• GORM is a popular ORM library for Go.

This server helps you scaffold applications using these technologies, following best practices for modular Go web development.

Learn More

• Model Context Protocol Documentation
• Echo Web Framework
• GORM ORM