本地开发环境

本文档介绍如何在本地设置和启动完整的 MCP Gateway 开发环境，包括启动所有必要的服务组件。

​

前提条件

在开始之前，请确保你的系统已安装以下软件：

​

项目架构概览

MCP Gateway 项目由以下几个核心组件组成：

​

环境搭建步骤

​

1. 获取源码

git clone https://github.com/your-github-username/unla.git
cd unla

​

2. 安装依赖

go mod tidy

cd web
npm i
cd ..

​

3. 配置环境

cp .env.example .env

cd web
cp .env.example .env
cd ..

​

启动开发服务

你需要 4 个终端窗口来运行所有服务。这种在宿主机上运行多个服务的方式，在开发过程中可以轻松的重启调试。

​

终端 1: 启动 mcp-gateway

go run cmd/gateway/main.go

mcp-gateway 默认会在 http://localhost:5235 上启动，用于处理 MCP 协议请求。

​

终端 2: 启动 apiserver

go run cmd/apiserver/main.go

apiserver 默认会在 http://localhost:5234 上启动。

​

终端 3: 启动 mock-server

go run cmd/mock-server/main.go

• mock-server 默认会在 http://localhost:5236 上启动
• mock-server-sse 默认会在 http://localhost:5237 上启动

​

终端 4: 启动 web 前端

cd web
npm run dev

web 终端运行命令后，会显示访问的地址。

​

访问管理界面

启动完成后，你可以在浏览器中访问终端显示的地址来访问管理界面。

​

常见问题

​

环境变量设置

某些服务可能需要特定的环境变量才能正常工作。可以在 .env 文件中设置这些变量：

# 示例环境变量
APISERVER_JWT_SECRET_KEY="changeme-please-generate-a-random-secret"
SUPER_ADMIN_USERNAME="admin"
SUPER_ADMIN_PASSWORD="changeme-please-use-a-secure-password"

​

端口冲突

如果遇到端口冲突，可以在环境变量中修改端口配置：

MCP_GATEWAY_PORT=5235
APISERVER_PORT=5234
MOCK_SERVER_PORT=5236

​

依赖问题

如果遇到依赖安装问题：

​

开发工作流

​

贡献代码流程

git remote add upstream git@github.com:amoylab/unla.git

git pull upstream main

git switch -c feat/your-feature-name

git push origin feat/your-feature-name

​

分支命名规范

​

开发注意事项

​

下一步

成功启动本地开发环境后，你可以：