HiMarket MCP Server集成教程：将外部API转换为标准MCP服务-拓冰建站

HiMarket MCP Server集成教程：将外部API转换为标准MCP服务

【免费下载链接】himarketHiMarket 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.项目地址: https://gitcode.com/gh_mirrors/hi/himarket

HiMarket作为企业级AI开放平台，提供了强大的MCP Server集成能力，能够将外部API快速转换为标准的MCP（Model Context Protocol）服务。MCP是连接AI模型与外部工具的标准协议，通过HiMarket的MCP Server集成功能，企业可以统一管理和分发AI能力，构建私有化的AI能力市场。

🔍 什么是MCP Server？

MCP（Model Context Protocol）是一种标准协议，允许AI模型与外部工具和服务进行交互。在HiMarket中，MCP Server扮演着AI能力适配器的角色，可以将各种外部API（如REST API、数据库接口、企业系统等）封装成标准的MCP工具，供AI模型调用。

MCP Server的核心优势

标准化接口：统一的MCP协议规范，降低集成复杂度
工具发现机制：支持动态工具发现和描述
安全可控：细粒度的权限控制和访问管理
多协议支持：支持SSE、HTTP等多种传输协议

🚀 MCP Server集成完整流程

第一步：创建MCP Server产品

在HiMarket管理控制台中，进入[API产品管理]页面，点击"创建API产品"按钮：

填写产品信息
- 产品名称：如weather-api-mcp
- 产品类型：选择"MCP Server"
- 产品描述：描述API的功能和用途
- 产品分类：选择合适的分类便于管理

第二步：配置MCP Server元数据

MCP Server的元数据配置是关键步骤，决定了外部API如何映射为MCP工具：

{ "mcpName": "weather-service", "displayName": "天气查询服务", "description": "提供全球城市天气查询功能", "protocolType": "HTTP", "connectionConfig": { "endpoint": "https://api.weather.com/v1", "authType": "API_KEY", "headers": { "Content-Type": "application/json" } } }

第三步：定义MCP工具规范

通过HiMarket的OpenAPI转换器，可以将外部API的OpenAPI规范自动转换为MCP工具配置：

# OpenAPI规范示例 openapi: 3.0.0 info: title: Weather API version: 1.0.0 paths: /weather: get: summary: 获取天气信息 parameters: - name: city in: query required: true schema: type: string responses: '200': description: 成功响应

HiMarket会自动将其转换为MCP工具配置，存储在himarket-server/src/main/java/com/alibaba/himarket/support/mcp/OpenAPIToolsConfigConverter.java中处理。

第四步：部署MCP Server端点

HiMarket支持多种部署方式：

部署方式	适用场景	配置路径
Higress网关	生产环境部署	`service/gateway/`
沙箱部署	开发测试环境	`sandbox/`
自托管	私有化部署	`himarket-server/src/main/java/com/alibaba/himarket/service/mcp/SelfHostedDeployStrategy.java`

第五步：注册MCP Server

通过HiMarket的REST API注册MCP Server：

// 注册MCP Server的Java示例 @PostMapping("/mcp-servers/register") public McpMetaResult register(@RequestBody @Valid RegisterMcpParam param) { McpMetaResult result = mcpServerService.registerMcp(param); return contextHolder.isAdministrator() ? result : result.sanitize(); }

完整的注册参数定义在himarket-server/src/main/java/com/alibaba/himarket/dto/params/mcp/RegisterMcpParam.java中。

🔧 MCP Server配置详解

连接配置

MCP Server支持多种连接配置：

HTTP/HTTPS端点

{ "protocolType": "HTTP", "connectionConfig": { "url": "https://api.example.com/mcp", "authType": "BEARER", "headers": { "Authorization": "Bearer {token}" } } }

SSE流式传输

{ "protocolType": "SSE", "connectionConfig": { "url": "https://api.example.com/mcp/events", "authType": "NONE" } }

工具配置

MCP工具配置定义了API如何被AI模型调用：

{ "tools": [ { "name": "get_weather", "description": "获取指定城市的天气信息", "inputSchema": { "type": "object", "properties": { "city": { "type": "string", "description": "城市名称" } }, "required": ["city"] } } ] }

📊 MCP Server管理功能

元数据管理

HiMarket提供了完整的MCP Server元数据管理API：

保存元数据：POST /mcp-servers/meta
获取元数据：GET /mcp-servers/meta/{mcpServerId}
批量查询：GET /mcp-servers/meta/batch
删除元数据：DELETE /mcp-servers/meta/{mcpServerId}

端点管理

MCP Server端点管理支持多种托管类型：

-- 数据库表结构定义 CREATE TABLE IF NOT EXISTS `mcp_server_endpoint` ( `endpoint_id` varchar(64) NOT NULL, `mcp_server_id` varchar(64) NOT NULL, `hosting_type` varchar(32) NOT NULL COMMENT 'NACOS / GATEWAY / SANDBOX', -- 更多字段... );

工具刷新与同步

支持动态刷新MCP工具列表：

@PostMapping("/meta/{mcpServerId}/refresh-tools") @AdminAuth public McpMetaResult refreshTools(@PathVariable String mcpServerId) { return mcpServerService.refreshTools(mcpServerId); }

🛡️ 安全与权限控制

认证机制

HiMarket MCP Server支持多种认证方式：

API密钥认证：适合机器对机器调用
Bearer Token认证：基于JWT的标准化认证
OAuth 2.0认证：支持标准的OAuth流程
无认证模式：用于公开API

权限控制

基于角色的访问控制（RBAC）：

管理员权限：完整的管理功能，定义在@AdminAuth注解中
开发者权限：查看和使用MCP服务，定义在@DeveloperAuth注解中
公开访问：无需认证的公开端点，使用@PublicAccess注解

🔄 集成工作流示例

场景：将天气预报API转换为MCP服务

步骤1：分析原始API

API端点：https://weather-api.com/v1/forecast
请求方式：GET
参数：city（城市名）、days（预报天数）

步骤2：创建MCP Server产品通过管理控制台或API创建产品，选择MCP Server类型。

步骤3：配置OpenAPI规范

paths: /forecast: get: operationId: getWeatherForecast parameters: - name: city in: query required: true - name: days in: query default: 3

步骤4：部署到Higress网关

# 通过HiMarket CLI部署 himarket mcp deploy \ --name weather-mcp \ --endpoint https://weather-api.com/v1 \ --gateway higress-prod

步骤5：测试MCP工具

# 在HiChat中测试MCP工具 import himarket client = himarket.Client() weather_tool = client.get_mcp_tool("weather-mcp", "get_weather_forecast") result = weather_tool.invoke({"city": "北京", "days": 3})