auto-mcp 的安装和配置教程

项目基础介绍

auto-mcp 是一个开源项目，旨在将任何 OpenAPI/Swagger 定义转换为一个功能完备的 Model Context Protocol (MCP) 服务器。该项目允许用户无需编写冗余代码，即可将 Swagger (OpenAPI v2) 文档转换并暴露通过 MCP 协议的端点。它支持多种部署方式，包括命令行工具、长时间运行的守护进程，以及 Docker 和 Kubernetes 容器环境。

该项目主要使用 Go 语言进行开发。

项目使用的关键技术和框架

• Go 语言：项目的主体语言，用于实现 MCP 服务器的核心功能。
• OpenAPI/Swagger：一种 RESTful API 的描述格式，用于定义项目的接口。
• Model Context Protocol (MCP)：一种协议，用于定义模型和上下文之间的交互方式。

安装和配置准备工作

在开始安装 auto-mcp 之前，请确保您的系统已经安装了以下软件：

• Go 语言环境（至少版本 1.16）
• Docker（如果需要在 Docker 环境中运行）

确保 Go 语言环境已正确安装并配置了 GOPATH 环境变量。

安装步骤

1. 克隆项目

首先，从 GitHub 上克隆 auto-mcp 项目到本地：

git clone https://github.com/brizzai/auto-mcp.git
cd auto-mcp

2. 安装 MCP 配置构建器

在项目目录中，使用以下命令安装 mcp-config-builder：

go install ./cmd/mcp-config-builder

这将构建并安装 mcp-config-builder 工具到您的 GOPATH/bin 目录（通常是 ~/go/bin），请确保此目录在您的 PATH 环境变量中。

3. 配置 Swagger 文件

使用 mcp-config-builder 工具来配置您的 Swagger 文件：

mcp-config-builder --swagger-file=/path/to/swagger.json

按照命令行界面（TUI）的提示来编辑和保存您的配置。

4. 运行 Auto MCP

在完成配置后，使用以下命令启动 auto-mcp 服务：

auto-mcp --swagger-file=/path/to/swagger.json --adjustment-file=/path/to/adjustments.json

如果需要在 Docker 容器中运行，请使用以下命令：

docker run --rm -i -v $(pwd)/swagger.json:/server/swagger.json ghcr.io/brizzai/auto-mcp:latest --swagger-file=/server/swagger.json

如果要使用 SSE 模式运行，请添加 --mode=sse 参数。

完成以上步骤后，您的 auto-mcp 服务器应该已经成功运行，并准备接收请求了。