higress-group

HiMarket AI 开放平台

Community higress-group
Updated

HiMarket is an enterprise-level "AI Capability Marketplace and Developer Ecosystem Hub." It is not merely a simple aggregation of traditional APIs, but rather a comprehensive platform that packages, publishes, manages, and operates core AI assets such as enterprise Model APIs, MCP Servers, Agent APIs, etc., through standardized product formats.

HiMarket AI 开放平台

HiMarket 是什么?

HiMarket 是一个开箱即用的 AI 开放平台解决方案,可以用于构建企业级的 AI 能力市场与开发者生态中心。

它由三大核心组件构成,完美匹配企业内不同角色的需求:

  1. AI 开放平台管理后台 (for 管理员/运营):在这里将底层的模型服务、MCP Server、Agent 等多样化的 AI 能力,以 API 的形式轻松打包成标准化的“AI 产品”,并配上完善的文档、示例,最终一键发布到门户。
  2. AI 开放平台门户 (for 开发者/企业内部用户):门户是面向内外开发者的“店面”。开发者可以在此完成开发者注册、创建消费者、获取凭证、浏览和订阅 AI 产品、在线测试,并清晰地监控自己的调用状态和成本。
  3. AI 网关:作为 Higress 社区的子项目,Higress AI 网关承载所有 AI 调用的认证、安全、流控、协议转换以及可观测性等能力。

快速入门

准备工作

  1. 安装 Githttps://git-scm.com/downloads
  2. 安装 JDK 8 或者更高版本
  3. 安装 Node.js(建议 v20 及以上)https://nodejs.org/
  4. 安装 Mavenhttps://maven.apache.org/download.cgi
  5. 准备数据库后端服务依赖外部数据库。你需要本地启动数据库(如 MySQL/MariaDB 等),并根据 portal-bootstrap 中的 application.yaml 文件配置数据库连接参数。

克隆项目代码

git clone https://github.com/higress-group/himarket.git
cd himarket

启动后端 portal-bootstrap

后端服务依赖外部数据库。请参考 portal-bootstrap/src/main/resources/application.yaml 配置数据库相关参数。也可以在启动时通过命令行参数覆盖这些配置。

启动方式

先打包:

mvn clean package

再启动:

java -Ddb.host=xxxx.mysql.rds.aliyuncs.com \
     -Ddb.port=3306 \
     -Ddb.name=xxx \
     -Ddb.username=xxx \
     -Ddb.password=xxx \
     -jar portal-bootstrap/target/portal-bootstrap-1.0-SNAPSHOT.jar

启动前端项目

1. portal-web/api-portal-admin
cd portal-web/api-portal-admin
npm install
npm run dev

本地访问地址参考控制台输出,一般为 http://localhost:5174

2. portal-web/api-portal-frontend
cd portal-web/api-portal-frontend
npm install
npm run dev

本地访问地址同上,一般为 http://${portal_frontend_domain}:5173

在本地开发过程中,portal_frontend_domain 需要配置域名解析(本地修改 /etc/hosts 文件),在 HiMarket 的设计中,门户域名是解析到对应门户 ID 的依据。

HiMarket 后台管理

注册管理员

访问 http://localhost:5174,首次访问注册一个管理员账号。

导入 Higress 实例

选择【实例管理】-【网关实例】-【导入网关实例】-【Higress 网关】,导入 Higress 网关实例,以 http://demo.higress.io 为例进行导入,用户名和密码均是 admin。

创建 Portal 门户

选择【Portal】-【创建 Portal】,创建一个名为 himarket-demo 的门户。

点击门户卡片,进入门户配置,其他配置保留默认选项即可,在 【Setting】-【域名管理】-【绑定域名】中,绑定一个 localhost 域名,用于开发自测。其他菜单在快速入门中可以先不用关注,这里简单介绍下他们的功能:

  • Published API Products。管理门户中发布的 API Product。
  • Developers。管理门户的 Developer,以及 Developer 关联的 Consumer。
  • Settings。
    • 配置门户的基本信息。
    • 控制门户中 Developer 的注册审批是否自动通过、API Product 订阅是否自动通过。
    • 门户支持的三方登录。支持标准的 OIDC 配置,如 Aliyun、Google、Github 等。
创建 API Product

选择【API Products】-【创建 API Product】,创建一个 demo-api 的 API Product。

API Product 的初始状态为“待配置”,需要进行 Link API、发布到门户等操作。

关联 API

关联一个网关的 MCP 服务,数据源来自于 Higress MCP 服务管理。API Config 也会自动同步 Higress 中的配置。

Usage Guide

可以在使用指南中编辑自定义的文档信息。

发布到门户

在 API Product 准备就绪后,可以选择发布到指定的门户。

至此,一个 Higress 的 MCP Server 成功发布到了门户。

HiMarket 门户

HiMarket 门户是多租户设计,通过域名来识别不同的门户实例。

门户会有一个默认分配的域名,但域名解析需要用户自己完成,例如自动分配了 portal-68ac4564bdb292ee9261ff4a.api.portal.local 域名,需要将其解析到 api-portal-frontend 对应的 IP 上。

由于刚刚已经额外配置了 localhost 域名给测试门户,所以也可以直接通过 localhost:5173 访问前台。

注册 Developer 开发者

由于门户之前在设置中未打开自动审批,注册账号后需要等待管理员后台审批开发者通过,审批通过后,方可使用注册的账号在前台登录。

访问 MCP 门户可以看到刚刚发布的 MCP Server

创建 Consumer 消费者

在 AI 开放平台的设计中,消费者 Developer 代表一般的用户身份,而用户需要持有对应的凭证才可以申请订阅 API Product,而凭证这一概念,在 AI 开放平台中称之为 Consumer 消费者,Developer 与 Consumer 是一对多的关联。

创建消费者之后,即可申请 API Product 的订阅

门户的默认配置中,订阅的审批是默认关闭的,即开发者申请后会自动审批通过。

发起调用

携带消费者的凭证,配置门户中 MCP Server 的连接地址,即可发起对 MCP Server 的调用。

阿里云开箱即用

阿里云计算巢支持了该项目开箱即用版本,可以使用下面链接一键部署社区版:

Deploy on AlibabaCloud ComputeNest

社区

交流群

image

技术分享

微信公众号:

关联仓库

贡献者

Star History

Star History

↑ 返回顶部 ↑

MCP Server · Populars

MCP Server · New