某大厂 HSF 转 MCP 实践：FastAPI-MCP 协议转换工具深度剖析-CSDN博客

本文链接：https://blog.csdn.net/lbh73/article/details/147947193

在微服务架构的浪潮下，HSF 与 MCP 这两种技术体系的融合，正成为某大厂技术升级的重要方向。本文将以通俗易懂的方式，深入解析某大厂 HSF 转 MCP 的实践方案，以及 FastAPI-MCP 协议转换工具的实现原理，让你轻松掌握这一关键技能。

一、某大厂 HSF 转 MCP ：从架构到实践

（一）架构背景与需求

在某大厂，HSF 作为内部广泛使用的服务框架，在多年的业务发展过程中，构建了庞大的微服务生态系统。然而，随着业务场景的拓展，尤其是与智能应用（类似 LLM 应用场景）的融合需求日益增长，传统的 HSF 服务调用模式面临着诸多挑战。比如，LLM 应用无法直接访问 HSF 服务中的实时数据、执行特定操作等。因此，将 HSF 服务转化为 MCP Server 形式，成为了打破技术壁垒、实现高效集成的关键需求。

（二）实践步骤详解

1. 环境准备

在开始 HSF 转 MCP 之前，需要确保开发环境已经配置好 HSF 开发相关依赖和工具，同时搭建好 MCP 开发环境，包括安装 FastAPI 框架以及相关 MCP 协议的依赖库等。这就好比在建造桥梁之前，先要准备好各种建筑材料和施工工具。

2. 服务识别与映射

对现有的 HSF 服务进行梳理，明确哪些服务需要被转换为 MCP Server 提供的功能。比如，一个用户订单服务中的查询订单详情接口，该接口在 HSF 中有特定的服务名和服务方法。我们需要将它映射到 MCP Server 的资源或工具模型中，确定它在 MCP 体系下的功能定位，是作为一个可读取的资源，还是作为一个可供调用的工具。

3. 利用 HSFOPS 后台进行初步配置

登录 HSF 运维（HSFOPS）后台，找到 MCP 相关的配置侧边栏。选择需要转换的 HSF 应用（确保自己对该应用有相应的权限），然后依次选择服务名和方法名。这一步就像是在 HSF 和 MCP 两个世界之间建立了一个指向标，告诉系统我们要对这个特定的服务进行转换操作。

4. 补充参数信息

针对选定的方法，补充标记为 “//TODO” 部分的入参的 fieldName 和 description。这一步是为了让转换后的 MCP Server 更清晰地展示服务接口的参数信息，方便后续调用。例如，如果一个方法的入参是一个用户 ID，那么 fieldName 就是 “user_id”，description 可以是 “用于查询的用户唯一标识”。

5. 以 MCP SSE 方式访问域名

当完成上述配置后，利用相应的工具以 MCP SSE（Server - Sent Events）的方式访问生成的域名。一般在 MCP Tool 创建完成后等待片刻，该工具就可以被 list 出来并供调用。这一步就像是启动了连接 HSF 服务与 MCP Server 的隧道，让两者之间可以开始数据交互。