HiMarket MCP server

The HiMarket AI Open Platform is a comprehensive solution for building enterprise-grade AI capability marketplaces and developer ecosystems. It connects AI models, MCP servers, and agents to users through standardized APIs, providing a complete ecosystem for AI service management and consumption.

Installation

Prerequisites

Before installing HiMarket, ensure you have the following prerequisites:

• Git - Available from git-scm.com/downloads
• JDK 8 or higher
• Node.js (v20+ recommended) - Available from nodejs.org
• Maven - Available from maven.apache.org/download.cgi
• Database - MySQL/MariaDB or compatible database

Getting the Code

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

Starting the Backend

The backend service requires a database connection. Configure the database parameters in portal-bootstrap/src/main/resources/application.yaml or override them using command-line arguments.

First, package the application:

mvn clean package

Then start the backend service:

java -Ddb.host=your-db-host.mysql.rds.example.com \
     -Ddb.port=3306 \
     -Ddb.name=your_database_name \
     -Ddb.username=your_username \
     -Ddb.password=your_password \
     -jar portal-bootstrap/target/portal-bootstrap-1.0-SNAPSHOT.jar

Starting the Frontend

Admin Portal

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

The admin portal will typically be available at http://localhost:5174

User Portal

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

The user portal will typically be available at http://localhost:5173

Note: For local development, you'll need to configure a domain name mapping in your hosts file, as HiMarket determines the portal ID from the domain name.

Usage Guide

Admin Portal Setup

Register Admin Account

1. Navigate to http://localhost:5174
2. Create an admin account during the first access

Import Higress Instance

1. Navigate to Instance Management > Gateway Instances > Import Gateway Instance > Higress Gateway
2. Enter the Higress gateway URL (e.g., http://demo.higress.io)
3. Enter credentials (default: admin/admin)

Create a Portal

1. Navigate to Portal > Create Portal
2. Name your portal (e.g., "himarket-demo")
3. In the portal settings, go to Settings > Domain Management > Bind Domain
4. Bind a localhost domain for testing purposes

Creating API Products

1. Navigate to API Products > Create API Product
2. Name your API product (e.g., "demo-api")
3. Link an API by selecting a gateway MCP service
4. Configure the Usage Guide with documentation for your API
5. Publish the API product to your portal

Using the User Portal

Developer Registration

1. Access your portal at http://localhost:5173
2. Register as a developer
3. Wait for admin approval (if automatic approval is disabled)

Creating Consumers

1. After logging in as a developer, navigate to the Consumers section
2. Create a consumer to obtain access credentials
3. The consumer acts as the credential holder for subscribing to API products

Subscribing to API Products

1. Browse available API products
2. Select the product you wish to use
3. Subscribe using your consumer credentials
4. If automatic approval is enabled, your subscription will be immediately active

Making API Calls

Use your consumer credentials with the MCP Server connection details from the portal to make API calls to the service.

One-Click Deployment

For a ready-to-use version, you can deploy the community edition with one click via Alibaba Cloud ComputeNest:

Deploy on Alibaba Cloud ComputeNest

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "himarket" '{"command":"npx","args":["-y","himarket"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "himarket": {
            "command": "npx",
            "args": [
                "-y",
                "himarket"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "himarket": {
            "command": "npx",
            "args": [
                "-y",
                "himarket"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect