기존 Echo API를 MCP 도구로 변환하고 AI Agent를 사용하여 API를 Model Context Protocol을 통해 상호 작용할 수 있습니다.

gin-mcp 하지만 Echo 프레임 워크에 영감을.

키 기능

• 영 구성: 기존 Echo API로 작동
• **멀티 슈마 소스 ** : Swaggo, Raw OpenAPI YAML / JSON 및 수동 스키마 지원 -Filtering: 와일드카드 패턴으로 엔드포인트 포함
• MCP 호환: MCP를 지원하는 모든 에이전트와 함께 작동합니다.
• Echo v5: labstack Echo v5와 통합 (breaking: v4 신청은, Echo 버전을 보십시오).

에코 버전

Echo-MCP는 Echo 주요 버전을 따르고 있습니다. 각 Echo 전공은 자체 Go 모듈에서 v4 및 v5 애플리케이션이 측면으로 지원할 수 있도록 합니다.

Echo v5가 *echo.Context] 핸들러 대신 echo.Context과 새로운 라우터 API, echo-mcp/v5 모듈은 Echo v4 애플리케이션과 vice versa와 호환되지 않습니다.

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: