What is Mcpgo

mcpgo is a Golang Echo Scaffolder MCP Server that implements the Model Context Protocol (MCP). It provides tools for scaffolding Echo web applications and related components, designed to work as a stdio MCP server compatible with various MCP clients and AI workflows.

Use cases

Use cases for mcpgo include quickly scaffolding new web applications, generating boilerplate code for models and services, creating API and HTML controllers, and providing solutions to common development issues in Echo applications.

How to use

To use mcpgo, install the server and interact with it via standard input/output. You can invoke various tools provided by the server to scaffold web applications, models, services, and controllers by sending the appropriate commands through an MCP client.

Key features

Key features of mcpgo include: 1) produce_app_boilerplate for scaffolding Echo web applications, 2) produce_model_boilerplate for generating GORM-compatible model boilerplate, 3) produce_service_boilerplate for creating service layers with DTOs, 4) produce_api_controller_boilerplate for API controllers, 5) produce_html_controller_boilerplate for HTML controllers, and 6) fix_app for troubleshooting common issues.

Where to use

mcpgo can be used in the development of web applications, particularly those built with the Echo framework. It is suitable for developers looking to streamline their workflow in creating scalable and maintainable applications.

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

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