BE

brunokrugel/echo-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

12 stars 8 forks Качество 76 Тренд 28GPL-3.0

Позволяет ИИ-помощникам взаимодействовать с вашим API Echo

Обзор

Оберните любой существующий API Echo в инструменты MCP и дайте возможность агентам ИИ взаимодействовать с вашим API через протокол Model Context. Вдохновленный джин-мкп, но для фреймворка Echo. Работает с любым существующим API Echo: Поддержка Swaggo, OpenAPI YAML/JSON и ручные схемы: Включать/исключать конечные точки с шаблонами wildcard - Работает с любым агентом, поддерживающим MCP. Теперь API доступен на http://localhost:8080/mcp Если вы уже используете Swaggo для документации Swagger, включите автоматическую генерацию схемы: Если вы используете другие библиотеки OpenAPI, такие как swaggest /openapi-go, вы можете пройти необработанную строку схемы YAML или JSON: Поле OpenAPISchema принимает строки формата YAML и JSON. При предоставлении он автоматически заполняет: - Имя сервера из заголовка схемы - Описание из описания схемы - Версия из версии схемы - Схемы инструментов из определений операций Выявление только необходимых конечных точек для инструментов MCP:

Обзор (машинный перевод)

Оберните любой существующий API Echo в инструменты MCP и дайте возможность агентам ИИ взаимодействовать с вашим API через протокол Model Context.

Вдохновленный джин-мкп, но для фреймворка Echo.

Ключевые особенности

** Нулевая конфигурация**: Работает с любым существующим API Echo Множественные источники схем: поддержка Swaggo, OpenAPI YAML/JSON и ручных схем ** Фильтрация**: Включать/исключать конечные точки с шаблонами wildcard MCP Compatible: работает с любым агентом, поддерживающим MCP. Echo v5: Интегрируется с Labstack Echo v5 (см. Echo Versions).

##Эхо-версии

Echo-MCP следует основной версии Echo, против которой он построен. Каждый Echo major живет в своем собственном модуле Go, так что приложения v4 и v5 могут поддерживаться бок о бок:

| Эхо-версия | Путь импорта | Место хранения

| Echo v4 | github.com/BrunoKrugel/echo-mcp | корень хранилища | |Echo v5 |github.com/BrunoKrugel/echo-mcp/v5 |v5/

Поскольку Echo v5 требует обработчиков *echo.Context вместо echo.Context и нового API маршрутизатора, модуль echo-mcp/v5 не совместим с приложениями Echo v4 и наоборот.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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:

Echo version Import path Repository location
Echo v4 github.com/BrunoKrugel/echo-mcp repository root
Echo v5 github.com/BrunoKrugel/echo-mcp/v5 v5/ directory

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:

Открыть полный README на GitHub

Установка

npx @modelcontextprotocol/inspector http://localhost:8080/mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "echo-api": { "type": "http", "url": "http://localhost:8080/mcp", "timeout": 120 }, } }