MCP 的网关

背景

Spring AI Alibaba MCP Gateway 基于 Nacos 提供的 MCP server registry 实现，为普通应用建立一个中间代理层 Java MCP 应用。一方面将 Nacos 中注册的服务信息转换成 MCP 协议的服务器信息，以便 MCP 客户端可以无缝调用这些服务；另一方面可以实现协议转化，将 MCP 协议转换为对后端 HTTP、Dubbo 等服务的调用。基于 Spring AI Alibaba MCP Gateway，您无需对原有业务代码进行改造，新增或者删除 MCP 服务（在 Nacos 中）无需重启代理应用。

示例代码可见：https://github.com/spring-ai-alibaba/examples/tree/main/spring-ai-alibaba-mcp-example/spring-ai-alibaba-mcp-nacos-example/server/mcp-nacos-gateway-example

pom 依赖

<dependencies>
    <dependency>
        <groupId>com.alibaba.cloud.ai</groupId>
        <artifactId>spring-ai-alibaba-starter-mcp-gateway</artifactId>
        <version>${spring-ai-extensions.version}</version>
    </dependency>

    <!-- MCP Server WebFlux 支持（也可换成 WebMvc） -->
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
        <version>${spring-ai.version}</version>
    </dependency>

</dependencies>

application.yml 文件

server:
  port: 19000

spring:
  application:
    name: mcp-gateway-server
  ai:
    mcp:
      server:
        name: mcp-nacos-gateway-example
        version: 1.0.0
        enabled: true
        protocol: _streamable_
_        _streamable-http:
          mcp-endpoint: /mcp
    dashscope:
      api-key: ${DASHSCOPE_API_KEY}

    alibaba:
      mcp:
        gateway:
          enabled: true
          nacos:
            service-names: mcp-nacos-restful # 注册至nacos中的restful，新命名的mcp服务名
        nacos:
          namespace: 0908ca08-c382-404c-9d96-37fe1628b183
          server-addr: 127.0.0.1:8848
          username: nacos
          password: nacos

存量 restful

事先准备好一个存量 restful 服务（DEFAULT/nacos-restful），该服务已被注册至 Nacos 中。

填写工具名称、工具描述 -> 时间服务
选择对应工具对应的接口
根据 restful 接口响应，选择响应模版

使用SAA Distributed MCP Client连接

使用spring-ai-alibaba-starter-mcp-distributed的客户端连接需要依赖nacos中注册的服务信息，由于存量转换类型的MCP在nacos中维护的服务信息是对应的 restful 服务而不是mcp服务，因此无法直接通过在Distributed MCP Client中配置这个存量服务进行连接，而是需要连接到gateway。

需要注意gateway模块默认不会注册为nacos的mcp服务和实例，因此需要将gateway注册为nacos的MCP服务。注册方式为在gateway项目的pom.xml中引入spring-ai-alibaba-starter-mcp-registry依赖。

<dependency>
  <groupId>com.alibaba.cloud.ai</groupId>
  <artifactId>spring-ai-alibaba-starter-mcp-registry</artifactId>
  <version>${spring-ai-extensions.version}</version>
</dependency>

同时需要修改application.yml配置文件，在spring.ai.alibaba.mcp.nacos下新增register配置项

spring:
  ai:
    alibaba:
      # MCP Gateway 配置
      mcp:
        gateway:
          ...
        # Nacos 注册中心配置
        nacos:
          server-addr: localhost:8848
          namespace: public
          username: nacos
          password: nacos
          register:
            enabled: true
            service-group: mcp-server       ## 指定分组名称
            service-name: mcp-nacos-gateway-example ## 指定服务名称