Himarket

🚀 HiMarket AI オープンプラットフォーム

HiMarket は、企業レベルの AI 能力市場と開発者エコシステムセンターを構築するための、すぐに使える AI オープンプラットフォームソリューションです。

🚀 クイックスタート

準備作業

1. Git のインストール https://git-scm.com/downloads
2. JDK 8 またはそれ以上のバージョンのインストール
3. Node.js のインストール（v20 以上を推奨） https://nodejs.org/
4. Maven のインストール https://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 の設定と自動的に同期されます。

使い方ガイド

使い方ガイドでは、カスタムドキュメント情報を編集することができます。

ポータルへの公開

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 は一般ユーザーを表し、ユーザーは対応する資格情報を持っている必要があります。この資格情報の概念は、AI オープンプラットフォームでは Consumer 消費者と呼ばれ、Developer と Consumer は 1 対多の関係になっています。

消費者を作成した後、API Product のサブスクリプションを申請することができます。

ポータルのデフォルト設定では、サブスクリプションの承認はデフォルトでオフになっています。つまり、開発者が申請すると自動的に承認されます。

呼び出しの実行

消費者の資格情報を持ち、ポータルの MCP Server の接続アドレスを設定すると、MCP Server の呼び出しを実行することができます。

阿里云でのすぐ使える環境

阿里雲のコンピュートネストはこのプロジェクトのすぐ使えるバージョンをサポートしています。以下のリンクを使用してコミュニティ版をワンクリックでデプロイできます：

✨ 主な機能

HiMarket は、企業内のさまざまな役割のニーズに完全に対応する 3 つの核心コンポーネントで構成されています：

1. AI オープンプラットフォーム管理バックエンド (管理者/運用者向け)：ここでは、基盤となるモデルサービス、MCP Server、Agent などの多様な AI 機能を API 形式で簡単に標準化された「AI 製品」にパッケージ化し、充実したドキュメントとサンプルを添付して、最終的にポータルにワンクリックで公開することができます。
2. AI オープンプラットフォームポータル (開発者/企業内ユーザー向け)：ポータルは内外の開発者向けの「店舗」です。開発者はここで開発者登録、消費者の作成、資格情報の取得、AI 製品の閲覧とサブスクリプション、オンラインテストを行い、自分の呼び出し状態とコストを明確に監視することができます。
3. AI ゲートウェイ：Higress コミュニティのサブプロジェクトとして、Higress AI ゲートウェイはすべての AI 呼び出しの認証、セキュリティ、流量制御、プロトコル変換、および可観測性などの機能を担っています。

コミュニティ

交流グループ

技術共有

微信公衆号：

関連リポジトリ

• Higress：https://github.com/alibaba/higress
• Higress コンソール：https://github.com/higress-group/higress-console

貢献者

Star 履歴

↑ ページトップに戻る ↑