Spring AI MCP Server怎么接入Claude Code的完整流程

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>4.1.2</version>
        <relativePath/>
    </parent>
    <groupId>com.example</groupId>
    <artifactId>order-mcp-server</artifactId>
    <version>0.0.1</version>
    <properties>
        <java.version>17</java.version>
        <spring-ai.version>2.0.2</spring-ai.version>
    </properties>
    <dependencyManagement>
        <dependencies>
            <!-- Spring AI 版本统一由 BOM 管 -->
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>${spring-ai.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

server:
  port: 18080
  # 只监听本机，HTTP 端点默认没有鉴权
  address: 127.0.0.1
spring:
  ai:
    mcp:
      server:
        name: order-mcp-server
        version: 0.0.1
        # 2.0 默认就是 STREAMABLE，写出来方便看
        protocol: STREAMABLE
        instructions: "订单查询工具，只读。"

package com.example.mcpdemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class OrderMcpApplication {

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

package com.example.mcpdemo;

import java.math.BigDecimal;
import java.util.List;
import java.util.Map;

import org.springframework.ai.mcp.annotation.McpTool;
import org.springframework.ai.mcp.annotation.McpToolParam;
import org.springframework.stereotype.Component;

@Component
public class OrderTools {

    public record Order(String orderNo, String status, BigDecimal amount, String createdAt) {
    }

    // 演示用内存数据，实际项目里换成注入的 OrderService
    private static final Map<String, Order> ORDERS = Map.of(
            "SO20261028001", new Order("SO20261028001", "PAID", new BigDecimal("199.00"), "2026-10-28 09:12"),
            "SO20261028002", new Order("SO20261028002", "SHIPPED", new BigDecimal("58.50"), "2026-10-28 10:40"),
            "SO20261029001", new Order("SO20261029001", "PAID", new BigDecimal("1288.00"), "2026-10-29 08:05"));

    @McpTool(name = "get_order", description = "按订单号查询订单详情，订单号形如 SO20261028001",
            annotations = @McpTool.McpAnnotations(readOnlyHint = true, destructiveHint = false, idempotentHint = true, openWorldHint = false))
    public Order getOrder(@McpToolParam(description = "订单号", required = true) String orderNo) {
        Order order = ORDERS.get(orderNo);
        if (order == null) {
            throw new IllegalArgumentException("订单不存在: " + orderNo);
        }
        return order;
    }

    @McpTool(name = "list_orders_by_status", description = "按状态列出订单，状态取值 PAID / SHIPPED",
            annotations = @McpTool.McpAnnotations(readOnlyHint = true, destructiveHint = false, idempotentHint = true, openWorldHint = false))
    public List<Order> listOrdersByStatus(
            @McpToolParam(description = "订单状态：PAID 或 SHIPPED", required = true) String status) {
        return ORDERS.values().stream()
                .filter(o -> o.status().equalsIgnoreCase(status))
                .sorted((a, b) -> a.orderNo().compareTo(b.orderNo()))
                .toList();
    }
}

# 在项目根目录打包并启动
mvn -DskipTests package
java -jar target/order-mcp-server-0.0.1.jar

o.s.a.m.s.c.a.McpServerAutoConfiguration : Enable tools capabilities, notification: true
o.s.a.m.s.c.a.McpServerAutoConfiguration : Registered tools: 2
o.s.boot.tomcat.TomcatWebServer          : Tomcat started on port 18080 (http) with context path '/'

# 第一步：握手，-D 把响应头存下来，里面有 Mcp-Session-Id
curl -s -D headers.txt http://127.0.0.1:18080/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"completions":{},"logging":{},"prompts":{"listChanged":true},"resources":{"subscribe":false,"listChanged":true},"tools":{"listChanged":true}},"serverInfo":{"name":"order-mcp-server","version":"0.0.1"},"instructions":"订单查询工具，只读。"}}

# 第二步：取会话 ID
SID=$(grep -i mcp-session-id headers.txt | awk '{print $2}' | tr -d '\r')

# 第三步：通知服务端初始化完成，返回 202
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:18080/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 第四步：调用 get_order
curl -s http://127.0.0.1:18080/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SID" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_order","arguments":{"orderNo":"SO20261028001"}}}'

id:f71d530b-99e1-42a6-931b-b4afc642f639
event:message
data:{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"{\"orderNo\":\"SO20261028001\",\"status\":\"PAID\",\"amount\":199.00,\"createdAt\":\"2026-10-28 09:12\"}"}],"isError":false}}

data:{"jsonrpc":"2.0","id":4,"result":{"content":[{"type":"text","text":"订单不存在: SO404\n订单不存在: SO404"}],"isError":true}}

{
  "mcpServers": {
    "order": {
      "type": "http",
      "url": "http://127.0.0.1:18080/mcp"
    }
  }
}

# --strict-mcp-config 表示只用这个文件里的 MCP 服务，不加载本机其他配置
# --allowedTools 预先放行两个工具，命名规则是 mcp__<服务名>__<工具名>
claude -p --mcp-config mcp.json --strict-mcp-config \
  --allowedTools "mcp__order__get_order" "mcp__order__list_orders_by_status" \
  "查一下订单 SO20261028001 的状态和金额；再列出所有 PAID 状态的订单号。只用 order 这个 MCP 服务的工具，回答控制在三行内。"

SO20261028001：状态 PAID，金额 199.00
PAID 状态订单：SO20261028001、SO20261029001

"annotations":{"title":"","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}

"annotations":{"title":"","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}