PAYATHON 2026

如何用 MCP Inspector 连接 Spring Boot MCP 服务?

数据小许

结论

描述中没有提供具体错误信息,目前无法确定原因。先确认 MCP Inspector 使用 Streamable HTTP,并连接到 Spring Boot 服务的完整地址,例如 http://localhost:8080/mcp。请将 8080 替换为应用实际监听的端口。

检查服务端配置

如果这些配置写在 application.properties 中,每项应单独占一行:

spring.ai.mcp.server.enabled=true
spring.ai.mcp.server.name=filter-mcp-server
spring.ai.mcp.server.version=0.0.1
spring.ai.mcp.server.protocol=STREAMABLE
spring.ai.mcp.server.type=ASYNC
spring.ai.mcp.server.endpoint=/mcp
spring.ai.mcp.server.stdio=false

如果原问题中的配置选项确实全部写在同一行,空格分隔的内容可能不会被解析为独立配置项。如果那只是提问时的排版方式,就不能据此判断配置有误。

检查连接步骤

  1. 启动 Spring Boot 应用,查看启动日志是否有配置错误,并确认应用实际监听的端口。
  2. 在 MCP Inspector v0.17.2 中选择 Streamable HTTP 传输方式。
  3. 将 URL 填为服务地址和配置的端点,例如 http://localhost:8080/mcp。
  4. 发起连接后,查看 Inspector 显示的错误,同时检查 Spring Boot 服务端日志。

如果 Inspector 运行在容器中或另一台机器上,localhost 指向的是 Inspector 所在环境,不一定是运行 Spring Boot 的机器。此时应填写 Inspector 可以访问的服务地址。

核对启动代码

问题中的启动方法写为 String args。如果源码也是这样,Java 的 main 方法应声明为 String[] args:

public static void main(String[] args) {
    SpringApplication.run(McpApplication.class, args);
}

如果项目目前可以正常编译并启动,这里可能只是提问时的简写或笔误。

仍无法连接时

请提供 Inspector 中的完整错误文本、服务端对应日志、实际监听端口,以及这些配置在项目中的写法。当前描述只说“出现错误”,没有附上具体内容,因此还无法判断是地址不可达、端点不匹配,还是服务端配置未生效。

备注:内容仅供参考。