JinDaGe - himarket MCP Details

article

README

🚀 HiMarket AI 开放平台

HiMarket 是一个开箱即用的 AI 开放平台解决方案，可用于构建企业级的 AI 能力市场与开发者生态中心，满足企业不同角色的多样化需求。

🚀 快速开始

准备工作

安装 Git：访问 Git 下载页面进行安装。
安装 JDK 8 或者更高版本。
安装 Node.js（建议 v20 及以上）：访问 Node.js 官网进行安装。
安装 Maven：访问 Maven 下载页面进行安装。
准备数据库：后端服务依赖外部数据库，你需要本地启动数据库（如 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。导入 Higress 实例

创建 Portal 门户

选择【Portal】-【创建 Portal】，创建一个名为 himarket-demo 的门户。创建 Portal 门户点击门户卡片，进入门户配置，其他配置保留默认选项即可，在【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

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

Usage Guide

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

发布到门户

在 API Product 准备就绪后，可以选择发布到指定的门户。发布到门户至此，一个 Higress 的 MCP Server 成功发布到了门户。

HiMarket 门户

HiMarket 门户是多租户设计，通过域名来识别不同的门户实例。门户会有一个默认分配的域名，但域名解析需要用户自己完成，例如自动分配了 portal-68ac4564bdb292ee9261ff4a.api.portal.local 域名，需要将其解析到 api-portal-frontend 对应的 IP 上。由于刚刚已经额外配置了 localhost 域名给测试门户，所以也可以直接通过 localhost:5173 访问前台。

注册 Developer 开发者

创建 Consumer 消费者

在 AI 开放平台的设计中，消费者 Developer 代表一般的用户身份，而用户需要持有对应的凭证才可以申请订阅 API Product，而凭证这一概念，在 AI 开放平台中称之为 Consumer 消费者，Developer 与 Consumer 是一对多的关联。创建 Consumer 消费者创建消费者之后，即可申请 API Product 的订阅申请 API Product 订阅门户的默认配置中，订阅的审批是默认关闭的，即开发者申请后会自动审批通过。

发起调用

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

阿里云开箱即用

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

himarket