既存の Echo API を MCP ツールにラップし、AI エージェントが Model Context プロトコルを介して API とやり取りできるようにします。

gin-mcp ではなく、Echo フレームワークに触発される。

主な特長

• ゼロ構成: 既存の Echo API と連携 -マルチプルスキーマソース:スワゴ、生OpenAPI YAML / JSON、マニュアルスキーマのサポート -Filtering:ワイルドカードパターンでエンドポイントを含める/除外 -MCP対応:MCP対応のエージェントと連携
• Echo v5:Labstack Echo v5と統合します(ブレイク:v4アプリケーションは移行し、Echoバージョンを参照してください)。

Echo バージョン

Echo-MCP は、Echo メジャーバージョンに反して構築されます。 各Echoは、それぞれ独自のGoモジュールに住んでおり、v4とv5のアプリケーションは、サイドでサポートすることができます。

| エコーバージョン | インポートパス | リポジトリ位置 | |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ※Echo v4** | [[T0] | リポジトリのルート | | ※Echo v5** | [[T1] | [[v5/] ディレクトリ |

Echo v5 は *echo.Context] の代わりに echo.Context と新しいルータ API を必要とするので、 echo-mcp/v5 モジュールは Echo v4 アプリケーションおよびその逆と互換性がありません.

MCP Wrapper for Echo Framework

Wrap any existing Echo API into MCP tools and enable AI agents to interact with your API through Model Context Protocol.

Inspired by gin-mcp but for the Echo framework.

Key Features

• Zero Configuration: Works with any existing Echo API
• Multiple Schema Sources: Support for Swaggo, raw OpenAPI YAML/JSON, and manual schemas
• Filtering: Include/exclude endpoints with wildcard patterns
• MCP Compatible: Works with any agent that supports MCP.
• Echo v5: Integrates with labstack Echo v5 (breaking: v4 applications must migrate, see Echo Versions).

Echo Versions

Echo-MCP follows the Echo major version it is built against. Each Echo major lives in its own Go module so that v4 and v5 applications can be supported side by side:

Since Echo v5 requires *echo.Context handlers instead of echo.Context and a new router API, the echo-mcp/v5 module is not compatible with Echo v4 applications and vice versa. Applications on Echo v4 should use the root module; applications on Echo v5 should use github.com/BrunoKrugel/echo-mcp/v5 (see the v5 branch for Echo framework v5 docs).

Installation

Use the module matching your Echo version:

# Echo v4 applications
go get github.com/BrunoKrugel/echo-mcp

# Echo v5 applications
go get github.com/BrunoKrugel/echo-mcp/v5

Quick Start

package main

import (
    "net/http"
    server "github.com/BrunoKrugel/echo-mcp/v5"
    "github.com/labstack/echo/v5"
)

func main() {
    e := echo.New()

    // Existing API routes
    e.GET("/ping", func(c *echo.Context) error {
        return c.JSON(http.StatusOK, map[string]string{"message": "pong"})
    })

    // Add MCP support
    mcp := server.New(e)
    mcp.Mount("/mcp")

    e.Start(":8080")
}

Now the API is accessible at http://localhost:8080/mcp

Advanced Usage

Automatic Swagger Schemas

If you already use Swaggo for Swagger documentation, enable automatic schema generation: