\n| \u9700\u8981\u7684\u73af\u5883\u53d8\u91cf<\/td>\n | ZHIPU_API_KEY\u3001AMAP_MAPS_API_KEY\u3001MCP_CODE_REVIEW_SERVER_URL<\/td>\n | \u4ec5 MCP_CODE_REVIEW_SERVER_URL<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n \u8fd9\u4e0d\u662f"\u5077\u5de5\u51cf\u6599"，\u800c\u662f\u52a1\u5b9e\u7684\u5de5\u7a0b\u51b3\u7b56\u3002\u751f\u4ea7\u73af\u5883\u6ca1\u6709\u914d\u7f6e\u667a\u8c31\u548c\u9ad8\u5fb7\u7684 API Key，\u5982\u679c\u4ecd\u7136\u5c1d\u8bd5\u5efa\u8fde，SSE \u957f\u8fde\u63a5\u4f1a\u53cd\u590d\u5931\u8d25，\u4ea7\u751f\u5927\u91cf SSE stream observed an error \u8b66\u544a，\u751a\u81f3\u62d6\u57ae\u5e94\u7528\u542f\u52a8\u3002<\/p>\n \u503c\u5f97\u6ce8\u610f\u7684\u6280\u672f\u7ec6\u8282：streamable-http.connections: {} \u4e0d\u662f"\u6ca1\u5199"，\u800c\u662f\u663e\u5f0f\u6e05\u7a7a\u3002\u5728 YAML \u4e2d\u5982\u679c\u53ea\u662f\u4e0d\u5199\u5185\u5bb9，Spring Boot \u7684 relaxed binding \u53ef\u80fd\u4f1a\u4ece default profile \u7ee7\u627f\u9ed8\u8ba4\u503c\u3002\u7528 connections: {} \u663e\u5f0f\u8bbe\u4e3a\u7a7a Map，\u624d\u80fd\u771f\u6b63\u8986\u76d6 default \u914d\u7f6e\u3002<\/p>\n \u4e09\u3001\u53ef\u89c2\u6d4b\u6027：\u8ba9\u6bcf\u6b21 MCP \u8c03\u7528\u90fd\u6709\u8ff9\u53ef\u5faa<\/h3>\n\u5f53 Client \u540c\u65f6\u8fde\u63a5\u591a\u4e2a MCP Server \u65f6，\u4e00\u6b21 \/mcp\/ask \u8bf7\u6c42\u53ef\u80fd\u89e6\u53d1\u591a\u6b21 tool call\u3002\u5982\u679c\u6bcf\u6b21\u8c03\u7528\u90fd\u662f"\u9ed1\u76d2"，\u51fa\u4e86\u95ee\u9898\u6839\u672c\u65e0\u4ece\u6392\u67e5\u3002Dream-SaaS \u7684\u89c2\u6d4b\u65b9\u6848\u5206\u4e09\u5c42：\u8c03\u7528\u7ea7\u65e5\u5fd7\u3001\u542f\u52a8\u7ea7\u8bca\u65ad\u548c\u5168\u94fe\u8def\u8ffd\u8e2a\u3002<\/p>\n 3.1 LoggingToolCallback：\u88c5\u9970\u5668\u6a21\u5f0f\u7684\u8c03\u7528\u65e5\u5fd7<\/h4>\nLoggingToolCallback \u7528\u88c5\u9970\u5668\u6a21\u5f0f\u5305\u88c5\u539f\u59cb ToolCallback，\u5728\u6bcf\u6b21\u5de5\u5177\u8c03\u7528\u524d\u540e\u63d2\u5165\u65e5\u5fd7\u3002\u8fd9\u662f\u6574\u4e2a\u89c2\u6d4b\u4f53\u7cfb\u7684\u57fa\u7840：<\/p>\n public final class LoggingToolCallback implements ToolCallback {<\/p>\n private static final Logger log = LoggerFactory.getLogger(
\n McpClientObservability.LOGGER_NAME);<\/p>\n private final ToolCallback delegate;<\/p>\n private LoggingToolCallback(ToolCallback delegate) {
\n this.delegate = delegate;
\n }<\/p>\n public static ToolCallback wrap(ToolCallback delegate) {
\n if (delegate == null) return null;
\n return new LoggingToolCallback(delegate);
\n }<\/p>\n @Override
\n public String call(String toolInput) {
\n String toolName = toolName();
\n String connection = resolveConnection(toolName);
\n int inputLen = toolInput == null ? 0 : toolInput.length();
\n long startMs = System.currentTimeMillis();<\/p>\n log.info("[MCP-TOOL] invoke | connection={} | tool={} | inputChars={}",
\n connection, toolName, inputLen);
\n try {
\n String result = delegate.call(toolInput);
\n long endMs = System.currentTimeMillis();
\n int resultLen = result == null ? 0 : result.length();
\n log.info("[MCP-TOOL] success | connection={} | elapsedMs={} | resultChars={}",
\n connection, endMs – startMs, resultLen);
\n appendToolSpan(toolName, connection, true, startMs, endMs, inputLen, resultLen, null);
\n return result;
\n } catch (RuntimeException ex) {
\n long endMs = System.currentTimeMillis();
\n log.info("[MCP-TOOL] failed | connection={} | elapsedMs={} | error={}",
\n connection, endMs – startMs, ex.getMessage());
\n appendToolSpan(toolName, connection, false, startMs, endMs, inputLen, 0, ex.getMessage());
\n throw ex;
\n }
\n }
\n} <\/p>\n \u88c5\u9970\u5668\u6a21\u5f0f\u7684\u8bbe\u8ba1\u8003\u91cf：\u8fd9\u91cc\u9009\u62e9\u88c5\u9970\u5668\u800c\u975e AOP \u6216 Filter，\u539f\u56e0\u6709\u4e09\u2014\u2014\u7b2c\u4e00，ToolCallback \u662f Spring AI \u7684\u63a5\u53e3，\u88c5\u9970\u5668\u662f\u6700\u81ea\u7136\u7684\u6269\u5c55\u65b9\u5f0f；\u7b2c\u4e8c，\u88c5\u9970\u5668\u53ef\u4ee5\u62ff\u5230 toolName() \u548c resolveConnection() \u7684\u4e0a\u4e0b\u6587\u4fe1\u606f，\u8fd9\u4e9b\u5728 AOP \u7684 JoinPoint \u4e2d\u4e0d\u5bb9\u6613\u83b7\u53d6；\u7b2c\u4e09，\u88c5\u9970\u5668\u7684\u5305\u88c5\u987a\u5e8f\u53ef\u63a7，\u907f\u514d\u88ab\u5176\u4ed6 AOP \u5207\u9762\u5e72\u6270\u3002<\/p>\n resolveConnection() \u901a\u8fc7\u5de5\u5177\u540d\u524d\u7f00\u63a8\u65ad\u8fde\u63a5\u5f52\u5c5e：<\/p>\n private static String resolveConnection(String toolName) {
\n if (toolName == null || toolName.isBlank()) return "unknown";
\n if (toolName.startsWith("maps_")) return "amap-maps";
\n if (toolName.startsWith("webSearch")) return "zhipu-web-search";
\n if (toolName.startsWith("review_") ||
\n toolName.startsWith("list_") ||
\n toolName.startsWith("get_")) return "code-review-local";
\n if (toolName.startsWith("graph_")) return "dream-ai-graph";
\n return "unknown";
\n} <\/p>\n \u5305\u88c5\u53d1\u751f\u5728 McpConfig \u7684 ChatClient \u88c5\u914d\u9636\u6bb5：<\/p>\n @Bean("mcpChatClient")
\npublic ChatClient mcpChatClient(ChatModel chatModel,
\n ObjectProvider<SyncMcpToolCallbackProvider> provider) {
\n ChatClient.Builder builder = ChatClient.builder(chatModel);
\n provider.ifAvailable(p -> {
\n ToolCallback[] wrapped = Arrays.stream(p.getToolCallbacks())
\n .map(LoggingToolCallback::wrap) \/\/ \u9010\u4e2a\u5305\u88c5
\n .toArray(ToolCallback[]::new);
\n builder.defaultToolCallbacks(wrapped);
\n });
\n return builder.build();
\n} <\/p>\n \u8fd9\u91cc\u4f7f\u7528 ObjectProvider<SyncMcpToolCallbackProvider> \u800c\u975e\u76f4\u63a5\u6ce8\u5165，\u662f\u5173\u952e\u7684\u8bbe\u8ba1\u9009\u62e9\u3002ObjectProvider \u662f Spring \u7684\u5ef6\u8fdf\u67e5\u627e\u673a\u5236，\u5982\u679c SyncMcpToolCallbackProvider \u4e0d\u5b58\u5728（\u6bd4\u5982 spring.ai.mcp.client.enabled=false），ifAvailable() \u4f1a\u9759\u9ed8\u8df3\u8fc7，\u4e0d\u4f1a\u5bfc\u81f4 Bean \u521b\u5efa\u5931\u8d25\u3002<\/p>\n 3.2 McpClientObservability：\u89c2\u6d4b\u5de5\u5177\u65b9\u6cd5\u96c6<\/h4>\nMcpClientObservability \u662f\u89c2\u6d4b\u4f53\u7cfb\u7684\u5de5\u5177\u7c7b，\u63d0\u4f9b\u4e86\u5de5\u5177\u6e05\u5355\u63d0\u53d6\u3001\u8fde\u63a5\u5206\u7ec4\u3001\u54cd\u5e94\u6458\u8981\u7b49\u8f85\u52a9\u65b9\u6cd5\u3002\u4ee5\u4e0b\u662f\u6838\u5fc3\u5b9e\u73b0：<\/p>\n public final class McpClientObservability {<\/p>\n public static final String LOGGER_NAME = "com.zhu.dream.ai.mcp.client.observability";<\/p>\n \/** \u63d0\u53d6 provider \u4e2d\u6240\u6709\u5de5\u5177\u540d（\u6392\u5e8f\u540e\u8fd4\u56de） *\/
\n public static List<String> toolNames(SyncMcpToolCallbackProvider provider) {
\n if (provider == null) return List.of();
\n return Arrays.stream(provider.getToolCallbacks())
\n .map(ToolCallback::getToolDefinition)
\n .map(def -> def != null ? def.name() : "?")
\n .sorted()
\n .toList();
\n }<\/p>\n \/** \u6309 connection \u5206\u7ec4\u5de5\u5177\u540d（\u57fa\u4e8e\u547d\u540d\u7ea6\u5b9a） *\/
\n public static Map<String, List<String>> groupToolsByConnection(
\n List<String> toolNames, List<String> configuredConnections) {
\n Map<String, List<String>> groups = new LinkedHashMap<>();
\n for (String connection : configuredConnections) {
\n groups.put(connection, new ArrayList<>());
\n }
\n groups.put("unclassified", new ArrayList<>());<\/p>\n for (String name : toolNames) {
\n String group = classifyToolConnection(name, configuredConnections);
\n groups.computeIfAbsent(group, k -> new ArrayList<>()).add(name);
\n }
\n groups.entrySet().removeIf(e -> e.getValue().isEmpty());
\n return groups;
\n }<\/p>\n \/** \u6587\u672c\u622a\u65ad（\u65e5\u5fd7\u5b89\u5168） *\/
\n public static String truncate(String text, int maxChars) {
\n if (text == null) return "";
\n if (text.length() <= maxChars) return text;
\n return text.substring(0, maxChars) + "\u2026";
\n }
\n} <\/p>\n groupToolsByConnection() \u7684\u8bbe\u8ba1\u610f\u56fe\u662f：\u542f\u52a8\u65f6\u8ba9\u8fd0\u7ef4\u4eba\u5458\u4e00\u773c\u770b\u6e05"\u6bcf\u4e2a connection \u4e0b\u9762\u6302\u4e86\u54ea\u4e9b tool"\u3002\u5206\u7ec4\u7684\u4f9d\u636e\u662f\u5de5\u5177\u540d\u524d\u7f00\u4e0e resolveConnection() \u76f8\u540c\u7684\u547d\u540d\u7ea6\u5b9a\u3002unclassified \u5206\u7ec4\u7528\u6765\u6536\u96c6\u65e0\u6cd5\u5f52\u7c7b\u7684\u5de5\u5177，\u65b9\u4fbf\u6392\u67e5\u662f\u5426\u6709\u5de5\u5177\u540d\u4e0d\u7b26\u5408\u7ea6\u5b9a\u3002<\/p>\n truncate() \u65b9\u6cd5\u770b\u4f3c\u7b80\u5355，\u4f46\u5728\u65e5\u5fd7\u573a\u666f\u4e0b\u975e\u5e38\u91cd\u8981\u2014\u2014\u7528\u6237\u95ee\u9898\u53ef\u80fd\u5f88\u957f，\u76f4\u63a5\u6253\u5230\u65e5\u5fd7\u91cc\u4f1a\u5bfc\u81f4\u65e5\u5fd7\u884c\u81a8\u80c0，\u5f71\u54cd\u65e5\u5fd7\u91c7\u96c6\u548c\u68c0\u7d22\u3002\u7edf\u4e00\u622a\u65ad\u5230 120 \u5b57\u7b26（\/mcp\/ask \u4e2d\u7684\u7528\u6cd5），\u65e2\u4fdd\u7559\u4e86\u8db3\u591f\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f，\u53c8\u907f\u514d\u65e5\u5fd7\u7206\u70b8\u3002<\/p>\n 3.3 McpClientStartupReporter：\u542f\u52a8\u7ea7\u8bca\u65ad<\/h4>\n\u8c03\u7528\u7ea7\u65e5\u5fd7\u89e3\u51b3\u7684\u662f"\u8fd0\u884c\u65f6\u53ef\u89c2\u6d4b"，\u4f46\u5f88\u591a MCP \u8fde\u63a5\u95ee\u9898\u53d1\u751f\u5728\u542f\u52a8\u9636\u6bb5\u3002McpClientStartupReporter \u5728\u542f\u52a8\u5b8c\u6210\u540e\u6253\u5370\u4e00\u4efd"\u5de5\u5177\u6e05\u5355"：<\/p>\n public void report() {
\n boolean mcpClientEnabled = environment.getProperty(
\n "spring.ai.mcp.client.enabled", Boolean.class, false);
\n List<String> configuredConnections =
\n McpClientObservability.configuredConnectionNames(environment);
\n SyncMcpToolCallbackProvider provider =
\n syncMcpToolCallbackProvider.getIfAvailable();
\n if (provider == null) {
\n log.info("[MCP-CLIENT] startup | enabled={} | "
\n + "provider=missing | configuredConnections={}",
\n mcpClientEnabled, configuredConnections);
\n return;
\n }
\n List<String> toolNames = McpClientObservability.toolNames(provider);
\n Map<String, List<String>> groups =
\n McpClientObservability.groupToolsByConnection(
\n toolNames, configuredConnections);
\n log.info("[MCP-CLIENT] startup | enabled={} | "
\n + "toolCount={} | toolGroups={}",
\n mcpClientEnabled, toolNames.size(), groups);
\n} <\/p>\n \u542f\u52a8\u540e\u4f60\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u65e5\u5fd7：<\/p>\n [MCP-CLIENT] startup | enabled=true | toolCount=5 | toolGroups={
\n code-review-local=[review_code, suggest_fix, analyze_complexity],
\n zhipu-web-search=[webSearch],
\n amap-maps=[maps_direction_driving, maps_geo]
\n} <\/p>\n \u6bcf\u4e2a connection \u4e0b\u9762\u6302\u4e86\u54ea\u4e9b tool，\u4e00\u76ee\u4e86\u7136\u3002\u5982\u679c provider=missing，\u8bf4\u660e Spring AI \u7684 MCP Client \u6ca1\u6709\u6b63\u786e\u521d\u59cb\u5316\u3002\u5982\u679c\u67d0\u4e2a connection \u4e0b tool \u6570\u91cf\u4e3a 0，\u8bf4\u660e\u5bf9\u5e94 Server \u7684\u5de5\u5177\u5217\u8868\u672a\u6210\u529f\u62c9\u53d6\u3002<\/p>\n 3.4 \u4e00\u6b21 \/mcp\/ask \u7684\u5b8c\u6574\u94fe\u8def<\/h4>\nMcpAskController \u662f Dream-SaaS \u7684 MCP \u95ee\u7b54\u5165\u53e3，\u5b83\u5c55\u793a\u4e86\u4e00\u6761\u5b8c\u6574\u7684\u8c03\u7528\u94fe\u8def\u3002\u4ee5\u4e0b\u662f executeAsk() \u7684\u5173\u952e\u7247\u6bb5：<\/p>\n private AskResult executeAsk(String question, String userId) {
\n String q = question == null ? "" : question;
\n String traceId = "mcp-" + UUID.randomUUID().toString()
\n .replace("-", "").substring(0, 16);
\n SyncMcpToolCallbackProvider provider = syncMcpToolCallbackProvider.getIfAvailable();
\n int toolCount = provider == null ? 0 : provider.getToolCallbacks().length;<\/p>\n log.info("[MCP-CLIENT] ask start | traceId={} | toolCount={} | question={}",
\n traceId, toolCount, McpClientObservability.truncate(q, 120));<\/p>\n long startMs = System.currentTimeMillis();
\n ObserveCallerContext.set(userId);
\n ObserveCallerContext.setRunId(traceId);
\n try {
\n ChatResponse chatResponse = chatClient.prompt().user(q).call().chatResponse();
\n AskSummary summary = McpClientObservability.summarizeAskResponse(chatResponse);
\n String content = McpClientObservability.extractAnswerText(chatResponse);
\n long durationMs = System.currentTimeMillis() – startMs;<\/p>\n \/\/ \u8865\u4e00\u6761 chat span，\u5de5\u5177\u7531 LoggingToolCallback \u5199\u5165
\n RunObserveBuffer.append(traceId,
\n RunObserveBuffer.chatSpan("mcp-chat-" + shortId(), null,
\n "mcp-ask", true, startMs, System.currentTimeMillis(),
\n Map.of("dreamsaas.source", "mcp",
\n "gen_ai.operation.name", "chat",
\n "mcp.registryToolCount", toolCount)));<\/p>\n log.info("[MCP-CLIENT] ask done | traceId={} | durationMs={} | "
\n + "answerChars={} | modelToolCalls={}",
\n traceId, durationMs, summary.answerChars(), summary.toolCallsSummary());
\n return new AskResult(content, toolCalls, durationMs, traceId);
\n } finally {
\n List<AgentSpanSnapshot> live = RunObserveBuffer.drain(traceId);
\n AgentTraceCapture cap = traceCapture.getIfAvailable();
\n if (cap != null) {
\n cap.capture(toSnapshot(traceId, userId, q, content, ok,
\n startMs, endMs, live, toolCalls, toolCount));
\n }
\n ObserveCallerContext.clear();
\n }
\n} <\/p>\n \u4e00\u6b21\u5b8c\u6574\u7684\u8bf7\u6c42\u94fe\u8def\u5982\u4e0b：<\/p>\n \n- \u8bf7\u6c42\u5230\u8fbe：\u751f\u6210\u552f\u4e00 traceId，\u8bb0\u5f55\u5f53\u524d\u53ef\u7528\u5de5\u5177\u6570<\/li>\n
- LLM \u51b3\u7b56：ChatClient.prompt().user(q).call() \u5c06\u95ee\u9898\u53d1\u7ed9\u5927\u6a21\u578b，\u6a21\u578b\u51b3\u5b9a\u8c03\u7528\u54ea\u4e9b MCP \u5de5\u5177<\/li>\n
- \u5de5\u5177\u6267\u884c：\u6bcf\u4e2a MCP \u5de5\u5177\u8c03\u7528\u7ecf\u8fc7 LoggingToolCallback，\u4ea7\u751f [MCP-TOOL] invoke \/ success \/ failed \u65e5\u5fd7<\/li>\n
- Trace \u91c7\u96c6：\u901a\u8fc7 RunObserveBuffer \u6536\u96c6\u6240\u6709 span（chat span + tool spans），finally \u5757\u4e2d\u901a\u8fc7 AgentTraceCapture \u6301\u4e45\u5316<\/li>\n
- \u7ed3\u679c\u6c47\u603b：\u54cd\u5e94\u4f53\u5305\u542b answer\u3001toolCalls\u3001durationMs\u3001traceId \u56db\u4e2a\u5173\u952e\u5b57\u6bb5<\/li>\n<\/ul>\n
\u5bf9\u5e94\u65e5\u5fd7\u94fe\u8def：<\/p>\n [MCP-CLIENT] ask start | traceId=mcp-a1b2c3d4e5f67890 | toolCount=5 | question=\u5e2e\u6211\u5ba1\u67e5\u8fd9\u6bb5\u4ee3\u7801…
\n[MCP-TOOL] invoke | connection=code-review-local | tool=review_code | inputChars=256
\n[MCP-TOOL] success | connection=code-review-local | elapsedMs=1823 | resultChars=1024
\n[MCP-TOOL] invoke | connection=code-review-local | tool=suggest_fix | inputChars=1024
\n[MCP-TOOL] success | connection=code-review-local | elapsedMs=982 | resultChars=512
\n[MCP-CLIENT] ask done | traceId=mcp-a1b2c3d4e5f67890 | durationMs=3842 | answerChars=386 <\/p>\n \u4ece ask start \u5230 ask done，\u4e2d\u95f4\u5939\u7740\u6bcf\u6b21\u5de5\u5177\u8c03\u7528\u7684 invoke \/ success\u2014\u2014\u8fd9\u5c31\u662f MCP \u5de5\u7a0b\u5316\u4e2d\u6700\u6734\u7d20\u7684"\u5168\u94fe\u8def\u8ffd\u8e2a"\u3002\u4e0d\u9700\u8981\u5f15\u5165 OpenTelemetry \u4e4b\u7c7b\u7684\u91cd\u578b\u6846\u67b6，\u7528\u88c5\u9970\u5668\u6a21\u5f0f + \u7ed3\u6784\u5316\u65e5\u5fd7\u5c31\u80fd\u8986\u76d6\u6838\u5fc3\u573a\u666f\u3002<\/p>\n \u56db\u3001\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406：\u63a2\u6d4b\u3001\u91cd\u8bd5\u4e0e\u4f18\u96c5\u964d\u7ea7<\/h3>\n\u524d\u4e09\u8282\u89e3\u51b3\u4e86"\u8fde\u54ea\u4e9b Server"\u3001"\u8c03\u7528\u8fc7\u7a0b\u600e\u4e48\u770b"\u7684\u95ee\u9898\u3002\u4f46\u8fd8\u6709\u4e00\u4e2a\u5173\u952e\u573a\u666f\u6ca1\u6709\u8986\u76d6：\u8fde\u63a5\u7684\u751f\u547d\u5468\u671f\u3002\u4e00\u4e2a MCP Server \u4e0d\u662f\u6c38\u8fdc\u5728\u7ebf\u7684，SSE \u957f\u8fde\u63a5\u53ef\u80fd\u56e0\u4e3a\u7f51\u7edc\u6296\u52a8\u65ad\u5f00，\u8fdc\u7aef\u670d\u52a1\u53ef\u80fd\u8d85\u65f6\u3002Dream-SaaS \u7684 McpConnectionDiagnostics \u63d0\u4f9b\u4e86\u4e00\u5957\u5b8c\u6574\u7684\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406\u65b9\u6848\u3002<\/p>\n 4.1 \u542f\u52a8\u65f6\u7684\u5f02\u6b65\u63a2\u6d4b<\/h4>\n\u5e94\u7528\u542f\u52a8\u5b8c\u6210\u540e，McpClientManager.logRegistryAlignment() \u5728\u5b8c\u6210\u540d\u518c\u5bf9\u9f50\u6821\u9a8c\u4e4b\u540e，\u8c03\u7528 McpConnectionDiagnostics.logProbeResultsAsync() \u5bf9\u6240\u6709\u5df2\u914d\u7f6e\u7684\u8fde\u63a5\u6267\u884c\u5f02\u6b65\u63a2\u6d4b\u3002\u6838\u5fc3\u63a2\u6d4b\u5165\u53e3：<\/p>\n public static void logProbeResultsAsync(Logger log, Environment env) {
\n List<ConnectionTarget> targets = resolveConnectionTargets(env);
\n if (targets.isEmpty()) {
\n log.warn("[MCP-CLIENT] connection probe | no connections found");
\n return;
\n }
\n \/\/ \u5148\u540c\u6b65\u6253\u5370\u914d\u7f6e\u4fe1\u606f
\n for (ConnectionTarget target : targets) {
\n String cred = credentialHint(target);
\n log.warn("[MCP-CLIENT] connection config | id={} | transport={} | "
\n + "target={} | credentialHint={}",
\n target.id(), target.transport(),
\n maskSecrets(target.fullUrl()),
\n cred != null ? cred : "none");
\n }
\n \/\/ \u518d\u5f02\u6b65\u6267\u884c\u63a2\u6d4b
\n CompletableFuture.runAsync(() -> logProbeResults(log, env))
\n .exceptionally(ex -> {
\n log.warn("[MCP-CLIENT] connection probe | async error={}", ex.toString());
\n return null;
\n });
\n} <\/p>\n \u5f02\u6b65\u63a2\u6d4b\u7684 CompletableFuture \u7528\u6cd5\u503c\u5f97\u5c55\u5f00\u8ba8\u8bba\u3002\u8fd9\u91cc\u7684\u8bbe\u8ba1\u610f\u56fe\u662f：\u542f\u52a8\u9636\u6bb5\u7684\u4e3b\u7ebf\u7a0b\u4e0d\u5e94\u8be5\u88ab\u7f51\u7edc\u63a2\u6d4b\u963b\u585e\u3002\u5982\u679c 3 \u4e2a\u8fde\u63a5\u4e2d\u6709 1 \u4e2a\u8fdc\u7aef\u65e0\u54cd\u5e94，\u540c\u6b65\u63a2\u6d4b\u4f1a\u5bfc\u81f4\u5e94\u7528\u542f\u52a8\u591a\u7b49 2 \u79d2（TCP \u8d85\u65f6），\u8fd9\u5728 CI\/CD \u73af\u5883\u4e2d\u7d2f\u79ef\u8d77\u6765\u5f88\u53ef\u89c2\u3002CompletableFuture.runAsync() \u5c06\u63a2\u6d4b\u4efb\u52a1\u63d0\u4ea4\u5230 ForkJoinPool，\u4e3b\u7ebf\u7a0b\u53ef\u4ee5\u7acb\u5373\u7ee7\u7eed\u6267\u884c\u540e\u7eed\u7684 Bean \u521d\u59cb\u5316\u3002<\/p>\n \u63a2\u6d4b\u7b56\u7565\u6309\u4f20\u8f93\u534f\u8bae\u5dee\u5f02\u5316：<\/p>\n \n- SSE \u8fde\u63a5：\u7528 TCP probe \u68c0\u6d4b\u76ee\u6807\u7aef\u53e3\u662f\u5426\u53ef\u8fbe（\u4e0d\u5bf9 SSE \u53d1 GET \u8bf7\u6c42，\u907f\u514d\u957f\u8fde\u63a5\u963b\u585e\u542f\u52a8）<\/li>\n
- streamable-http \u8fde\u63a5：\u7528 HTTP HEAD \u8bf7\u6c42\u68c0\u6d4b\u7aef\u70b9\u662f\u5426\u5b58\u6d3b<\/li>\n
- \u8d85\u65f6\u63a7\u5236：TCP \u63a2\u6d4b\u8d85\u65f6 2 \u79d2，HTTP \u63a2\u6d4b\u8d85\u65f6 2 \u79d2，\u6240\u6709\u8fde\u63a5\u7684\u63a2\u6d4b\u603b\u8d85\u65f6 8 \u79d2<\/li>\n<\/ul>\n
TCP probe \u7684\u5b9e\u73b0：<\/p>\n private static ProbeResult probeTcp(ConnectionTarget target) {
\n try {
\n URI uri = URI.create(target.fullUrl());
\n String host = uri.getHost();
\n int port = uri.getPort();
\n if (port <= 0) {
\n port = "https".equalsIgnoreCase(uri.getScheme()) ? 443 : 80;
\n }
\n try (Socket socket = new Socket()) {
\n socket.connect(new InetSocketAddress(host, port),
\n (int) TCP_TIMEOUT.toMillis());
\n }
\n return new ProbeResult(target.id(), target.transport(),
\n maskSecrets(target.fullUrl()), true, null, null,
\n "TCP \u53ef\u8fbe（SSE \u4e0d\u5bf9 GET \u505a probe，\u907f\u514d\u957f\u8fde\u63a5\u963b\u585e）");
\n } catch (Exception e) {
\n Throwable root = rootCause(e);
\n return failed(target, root.getClass().getSimpleName(), null, root);
\n }
\n} <\/p>\n \u8fd9\u662f\u4e00\u4e2a\u5bb9\u6613\u8e29\u5751\u7684\u8bbe\u8ba1\u51b3\u7b56：SSE \u7aef\u70b9\u54cd\u5e94 GET \u8bf7\u6c42\u540e\u4f1a\u4fdd\u6301\u957f\u8fde\u63a5\u4e0d\u5173\u95ed\u3002\u5982\u679c\u5bf9 SSE \u7aef\u70b9\u53d1 HTTP GET \u505a\u5065\u5eb7\u68c0\u67e5，\u8fd9\u4e2a\u8fde\u63a5\u4f1a\u4e00\u76f4\u6302\u7740，\u963b\u585e\u63a2\u6d4b\u7ebf\u7a0b\u3002\u6240\u4ee5\u53ea\u505a TCP \u5c42\u7684\u7aef\u53e3\u53ef\u8fbe\u6027\u68c0\u6d4b\u2014\u2014\u77e5\u9053\u7aef\u53e3\u901a\u4e86\u5c31\u591f\u4e86\u3002<\/p>\n 4.2 \u9519\u8bef\u5206\u7c7b\u4e0e\u667a\u80fd\u63d0\u793a<\/h4>\nMcpConnectionDiagnostics \u5bf9\u63a2\u6d4b\u5931\u8d25\u7684\u60c5\u51b5\u8fdb\u884c\u5206\u7c7b，\u7ed9\u51fa\u53ef\u76f4\u63a5\u6267\u884c\u7684\u6392\u67e5\u5efa\u8bae：<\/p>\n \n\u9519\u8bef\u7c7b\u578b\u89e6\u53d1\u6761\u4ef6\u8bca\u65ad\u63d0\u793a<\/tr>\n \n\n| CREDENTIAL<\/td>\n | URL \u4e2d\u7684 ${ZHIPU_API_KEY:} \u89e3\u6790\u4e3a\u7a7a<\/td>\n | \u73af\u5883\u53d8\u91cf ZHIPU_API_KEY \u672a\u8bbe\u7f6e<\/td>\n<\/tr>\n | \n| ConnectException<\/td>\n | TCP probe \u629b\u51fa Connection refused<\/td>\n | \u76ee\u6807 Server \u672a\u542f\u52a8\u6216\u7aef\u53e3\u4e0d\u53ef\u8fbe<\/td>\n<\/tr>\n | \n| HTTP 401\/403<\/td>\n | HTTP HEAD \u8fd4\u56de 401 \u6216 403<\/td>\n | API Key \u65e0\u6548\u6216\u5df2\u8fc7\u671f<\/td>\n<\/tr>\n | \n| ProbeTimeout<\/td>\n | \u63a2\u6d4b\u8d85\u8fc7\u603b\u8d85\u65f6（8s）<\/td>\n | \u63a2\u6d4b\u8d85\u65f6：\u4e0d\u5bf9 SSE \u53d1 GET，\u907f\u514d\u957f\u8fde\u63a5\u963b\u585e\u542f\u52a8<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n credentialHint() \u65b9\u6cd5\u4e13\u95e8\u5904\u7406\u51ed\u636e\u7f3a\u5931\u7684\u60c5\u51b5：<\/p>\n public static String credentialHint(ConnectionTarget target) {
\n String fullUrl = target.fullUrl();
\n if (containsEmptyQueryParam(fullUrl, "Authorization")) {
\n return "\u73af\u5883\u53d8\u91cf ZHIPU_API_KEY \u672a\u8bbe\u7f6e（sse-endpoint \u4e2d Authorization= \u4e3a\u7a7a）";
\n }
\n if (containsEmptyQueryParam(fullUrl, "key")) {
\n return "\u73af\u5883\u53d8\u91cf AMAP_MAPS_API_KEY \u672a\u8bbe\u7f6e（endpoint \u4e2d key= \u4e3a\u7a7a）";
\n }
\n if ("code-review-local".equals(target.id())
\n && (fullUrl == null || fullUrl.isBlank())) {
\n return "code-review-local \u7684 url \u672a\u914d\u7f6e，\u68c0\u67e5 MCP_CODE_REVIEW_SERVER_URL";
\n }
\n return null;
\n} <\/p>\n probeFailureHint() \u5219\u6839\u636e\u5f02\u5e38\u7c7b\u578b\u548c HTTP \u72b6\u6001\u7801\u5339\u914d\u6392\u67e5\u5efa\u8bae：<\/p>\n public static String probeFailureHint(ConnectionTarget target,
\n Throwable error, Integer httpStatus) {
\n String credentialHint = credentialHint(target);
\n if (credentialHint != null) return credentialHint;
\n if (error instanceof ConnectException) {
\n if ("code-review-local".equals(target.id())) {
\n return "TCP \u8fde\u63a5\u88ab\u62d2\u7edd：8095 \u672a\u76d1\u542c\u3002\u5148\u542f\u52a8 code-review-agent";
\n }
\n return "TCP\/\u7f51\u7edc\u4e0d\u53ef\u8fbe：\u68c0\u67e5 url \u662f\u5426\u6b63\u786e\u3001\u8fdc\u7aef\u670d\u52a1\u662f\u5426\u542f\u52a8";
\n }
\n if (httpStatus != null) {
\n if (httpStatus == 401 || httpStatus == 403) {
\n return "\u8ba4\u8bc1\u5931\u8d25：\u68c0\u67e5 API Key \u662f\u5426\u6709\u6548\u3001\u662f\u5426\u8fc7\u671f";
\n }
\n }
\n if (error instanceof HttpTimeoutException || error instanceof TimeoutException) {
\n return "\u63a2\u6d4b\u8d85\u65f6：\u8fdc\u7aef\u65e0\u54cd\u5e94\u6216\u7f51\u7edc\u6162";
\n }
\n return "SDK \u5c42 WARN\u300cSSE stream observed an error\u300d\u8bf7\u5bf9\u7167 connectionId \u4e0e target";
\n} <\/p>\n \u8fd9\u79cd"\u4e0d\u53ea\u544a\u8bc9\u4f60\u9519\u4e86，\u8fd8\u544a\u8bc9\u4f60\u600e\u4e48\u6539"\u7684\u8bbe\u8ba1，\u5927\u5e45\u964d\u4f4e\u4e86\u65b0\u4eba\u7684\u6392\u67e5\u6210\u672c\u3002<\/p>\n maskSecrets() \u65b9\u6cd5\u786e\u4fdd URL \u5728\u65e5\u5fd7\u4e2d\u8131\u654f：<\/p>\n public static String maskSecrets(String url) {
\n if (url == null || url.isBlank()) return "";
\n return url.replaceAll("(?i)(Authorization=)[^&]*", "$1***")
\n .replaceAll("(?i)([?&]key=)[^&]*", "$1***")
\n .replaceAll("(?i)([?&]token=)[^&]*", "$1***");
\n} <\/p>\n \u6b63\u5219\u5339\u914d\u8986\u76d6\u4e86\u4e09\u79cd\u5e38\u89c1\u7684\u51ed\u636e\u53c2\u6570\u540d：Authorization\u3001key\u3001token\u3002\u65e0\u8bba URL \u4e2d\u643a\u5e26\u54ea\u79cd\u51ed\u636e，\u65e5\u5fd7\u4e2d\u90fd\u4f1a\u663e\u793a\u4e3a ***\u3002<\/p>\n 4.3 SSE \u957f\u8fde\u63a5\u65ad\u5f00\u4e0e\u81ea\u52a8\u91cd\u8fde<\/h4>\nSSE \u662f\u4e00\u79cd\u957f\u8fde\u63a5\u534f\u8bae\u3002\u7f51\u7edc\u6296\u52a8\u3001Server \u91cd\u542f\u3001\u8d1f\u8f7d\u5747\u8861\u5668\u8d85\u65f6\u7b49\u60c5\u51b5\u90fd\u53ef\u80fd\u5bfc\u81f4 SSE \u8fde\u63a5\u65ad\u5f00\u3002Spring AI \u7684 MCP Client \u5185\u7f6e\u4e86 SSE \u91cd\u8fde\u673a\u5236\u2014\u2014\u5f53 SSE \u8fde\u63a5\u65ad\u5f00\u65f6，Client \u4f1a\u81ea\u52a8\u5c1d\u8bd5\u91cd\u65b0\u5efa\u7acb\u8fde\u63a5，\u65e5\u5fd7\u4e2d\u4f1a\u51fa\u73b0 SSE stream observed an error \u540e\u8ddf\u91cd\u65b0\u8fde\u63a5\u7684\u5c1d\u8bd5\u3002\u8fd9\u79cd\u91cd\u8fde\u662f\u900f\u660e\u7684，\u5e94\u7528\u4ee3\u7801\u65e0\u9700\u5173\u5fc3\u3002<\/p>\n \u4f46\u8981\u6ce8\u610f：\u91cd\u8fde\u671f\u95f4\u53d1\u8d77\u7684\u5de5\u5177\u8c03\u7528\u4f1a\u5931\u8d25\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48 LoggingToolCallback \u7684 failed \u65e5\u5fd7\u975e\u5e38\u5173\u952e\u2014\u2014\u901a\u8fc7 error= \u5b57\u6bb5\u53ef\u4ee5\u5feb\u901f\u5224\u65ad\u662f"\u8fde\u63a5\u65ad\u5f00\u5bfc\u81f4\u8c03\u7528\u5931\u8d25"\u8fd8\u662f"\u5de5\u5177\u6267\u884c\u672c\u8eab\u51fa\u9519"\u3002<\/p>\n streamable-http \u7684\u5904\u7406\u65b9\u5f0f\u4e0d\u540c\u3002streamable-http \u672c\u8d28\u4e0a\u662f\u4e00\u6b21\u6027\u7684 HTTP \u8bf7\u6c42，\u6bcf\u6b21\u5de5\u5177\u8c03\u7528\u53d1\u8d77\u72ec\u7acb\u7684\u8bf7\u6c42-\u54cd\u5e94，\u4e0d\u5b58\u5728"\u957f\u8fde\u63a5\u65ad\u5f00"\u7684\u95ee\u9898\u3002\u8fd9\u4e5f\u662f MCP 2026-07-28 \u65b0\u89c4\u8303\u5c06 streamable-http \u63d0\u5347\u4e3a\u63a8\u8350\u4f20\u8f93\u7684\u539f\u56e0\u4e4b\u4e00\u2014\u2014\u5b83\u5929\u7136\u66f4\u9002\u5408\u751f\u4ea7\u73af\u5883\u4e2d\u7684\u8d1f\u8f7d\u5747\u8861\u548c\u65e0\u72b6\u6001\u90e8\u7f72\u3002<\/p>\n 4.4 \u8fdc\u7a0b MCP \u8d85\u65f6\u7684\u964d\u7ea7\u7b56\u7565<\/h4>\n\u8fdc\u7a0b MCP Server（\u667a\u8c31\u3001\u9ad8\u5fb7）\u7684\u54cd\u5e94\u65f6\u95f4\u4e0d\u53ef\u63a7\u3002Dream-SaaS \u7684\u964d\u7ea7\u7b56\u7565\u5206\u4e24\u5c42：<\/p>\n \n- \u8fde\u63a5\u7ea7\u8d85\u65f6：Spring AI \u7684 SSE\/streamable-http \u4f20\u8f93\u5c42\u914d\u7f6e\u4e86\u8fde\u63a5\u8d85\u65f6\u548c\u8bfb\u53d6\u8d85\u65f6\u3002\u8d85\u65f6\u540e\u5e95\u5c42\u629b\u51fa\u5f02\u5e38，LoggingToolCallback \u6355\u83b7\u5e76\u8bb0\u5f55 [MCP-TOOL] failed \u65e5\u5fd7<\/li>\n
- \u5e94\u7528\u7ea7\u964d\u7ea7：\/mcp\/ask \u7aef\u70b9\u5728\u5de5\u5177\u8c03\u7528\u5931\u8d25\u65f6，\u8fd4\u56de\u7ed3\u6784\u5316\u7684\u9519\u8bef\u4fe1\u606f\u2014\u2014\u5305\u542b\u5931\u8d25\u7684 connection\u3001tool \u540d\u79f0\u548c\u9519\u8bef\u7c7b\u578b，\u800c\u4e0d\u662f\u76f4\u63a5\u629b 500\u3002LLM \u53ef\u4ee5\u636e\u6b64\u51b3\u5b9a"\u4e0d\u4f9d\u8d56\u8be5\u5de5\u5177，\u7528\u5df2\u6709\u4fe1\u606f\u7ee7\u7eed\u56de\u7b54"<\/li>\n<\/ul>\n
\u4ece\u65e5\u5fd7\u5173\u952e\u5b57\u53ef\u4ee5\u8ffd\u8e2a\u964d\u7ea7\u7684\u5b8c\u6574\u94fe\u8def：[MCP-TOOL] invoke \u2192 [MCP-TOOL] failed | elapsedMs=2003（\u8d85\u65f6）\u2192 \u5e94\u7528\u5c42\u8fd4\u56de\u7ed3\u6784\u5316\u9519\u8bef\u7ed9 LLM\u3002elapsedMs \u5b57\u6bb5\u662f\u5224\u65ad"\u662f\u8d85\u65f6\u8fd8\u662f\u6267\u884c\u6162"\u7684\u5173\u952e\u4f9d\u636e\u3002<\/p>\n 4.5 \/mcp\/status：\u7efc\u5408\u8bca\u65ad\u7aef\u70b9<\/h4>\n\u8bca\u65ad\u548c\u63a2\u6d4b\u7684\u6700\u7ec8\u4ea7\u51fa，\u901a\u8fc7 \/mcp\/status \u7aef\u70b9\u66b4\u9732\u7ed9\u8fd0\u7ef4\u548c\u5f00\u53d1\u4eba\u5458\u3002McpClientStatusController \u6574\u5408\u4e86\u6240\u6709\u89c2\u6d4b\u4fe1\u606f：<\/p>\n @RestController
\n@RequestMapping("\/mcp")
\npublic class McpClientStatusController {<\/p>\n @GetMapping("\/status")
\n public Map<String, Object> status() {
\n Map<String, Object> body = new LinkedHashMap<>();
\n body.put("mcpClientEnabled", mcpClientEnabled);
\n body.put("askEnabled", askEnabled);
\n body.put("observabilityLogger", McpClientObservability.LOGGER_NAME);
\n body.put("platform", "dream-ai-mcp");<\/p>\n \/\/ Registry \u540d\u518c\u5feb\u7167
\n McpClientManager manager = mcpClientManager.getIfAvailable();
\n if (manager != null) {
\n body.put("registry", manager.snapshot());
\n }<\/p>\n \/\/ \u8fde\u63a5\u63a2\u6d4b\u7ed3\u679c
\n body.put("configuredConnections",
\n McpClientObservability.configuredConnectionNames(environment));
\n body.put("connectionProbes",
\n McpConnectionDiagnostics.probeAll(environment).stream()
\n .map(McpConnectionDiagnostics::toStatusMap).toList());<\/p>\n \/\/ Provider \u72b6\u6001\u548c\u5de5\u5177\u6e05\u5355
\n SyncMcpToolCallbackProvider provider =
\n syncMcpToolCallbackProvider.getIfAvailable();
\n if (provider == null) {
\n body.put("providerReady", false);
\n body.put("toolCount", 0);
\n body.put("hint", "spring.ai.mcp.client.enabled=true \u4e14 MCP Server \u5c31\u7eea…");
\n return body;
\n }<\/p>\n List<String> toolNames = McpClientObservability.toolNames(provider);
\n body.put("providerReady", true);
\n body.put("toolCount", toolNames.size());
\n body.put("tools", toolNames);
\n body.put("toolGroups",
\n McpClientObservability.groupToolsByConnection(
\n toolNames, configuredConnections));
\n return body;
\n }
\n} <\/p>\n \u8fd9\u4e2a\u7aef\u70b9\u8fd4\u56de\u7684\u4fe1\u606f\u5305\u62ec：<\/p>\n \n- mcpClientEnabled \/ askEnabled：\u529f\u80fd\u5f00\u5173\u72b6\u6001<\/li>\n
- registry：\u540d\u518c\u5feb\u7167（profile\u3001expectedConnections\u3001connections\u3001servers）<\/li>\n
- connectionProbes：\u6bcf\u4e2a\u8fde\u63a5\u7684\u63a2\u6d4b\u7ed3\u679c（reachable\u3001errorType\u3001hint）<\/li>\n
- toolGroups：\u5de5\u5177\u6309 connection \u5206\u7ec4\u7684\u6e05\u5355<\/li>\n<\/ul>\n
\u90e8\u7f72\u540e\u7684\u6807\u51c6\u9a8c\u6536\u6d41\u7a0b\u662f：\u542f\u52a8\u5e94\u7528 \u2192 \u67e5\u770b\u542f\u52a8\u65e5\u5fd7\u4e2d\u7684 [MCP-CLIENT] startup \u548c [MCP-CLIENT] connection probe \u2192 \u8bbf\u95ee \/mcp\/status \u786e\u8ba4\u6240\u6709 connection \u72b6\u6001 \u2192 \u901a\u8fc7 \/mcp\/ask \u53d1\u9001\u6d4b\u8bd5\u8bf7\u6c42\u9a8c\u8bc1\u7aef\u5230\u7aef\u94fe\u8def\u3002\u8fd9\u5957\u6d41\u7a0b\u8ba9 MCP \u7684\u90e8\u7f72\u9a8c\u6536\u4ece"\u51ed\u611f\u89c9"\u53d8\u6210\u4e86"\u770b\u6570\u636e"\u3002<\/p>\n \u603b\u7ed3<\/h3>\nMCP \u5de5\u7a0b\u5316\u7684\u4e09\u9053\u574e\u2014\u2014\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u53ef\u89c2\u6d4b\u3001\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406\u2014\u2014\u4e0d\u662f\u7406\u8bba\u95ee\u9898，\u800c\u662f\u6bcf\u4e2a\u843d\u5730 MCP \u7684\u56e2\u961f\u90fd\u4f1a\u9047\u5230\u7684\u5b9e\u9645\u6311\u6218\u3002Dream-SaaS \u7684\u9009\u62e9\u662f：\u4e0d\u5f15\u5165\u989d\u5916\u57fa\u7840\u8bbe\u65bd，\u7528\u6a21\u5757\u5316\u7684 Registry \u540d\u518c\u3001\u88c5\u9970\u5668\u6a21\u5f0f\u7684\u89c2\u6d4b\u65e5\u5fd7\u3001\u5f02\u6b65\u63a2\u6d4b\u4e0e\u9519\u8bef\u5206\u7c7b\u673a\u5236\u6765\u89e3\u51b3\u3002\u8fd9\u5957\u65b9\u6848\u8f7b\u91cf\u3001\u53ef\u63a7\u3001\u53ef\u6f14\u8fdb\u3002<\/p>\n \u56de\u987e\u6574\u4e2a MCP \u5b50\u7cfb\u5217\u7684\u4e09\u7bc7\u6587\u7ae0：<\/p>\n \n- MCP-01 \u534f\u8bae\u5168\u89e3：\u62c6\u89e3\u4e86 MCP \u7684\u534f\u8bae\u8bbe\u8ba1\u2014\u2014JSON-RPC \u6d88\u606f\u683c\u5f0f\u3001Host\/Client\/Server \u4e09\u89d2\u67b6\u6784\u3001\u4f20\u8f93\u5c42\u89e3\u8026<\/li>\n
- MCP-02 Server \u5f00\u53d1\u5b9e\u6218：\u4ece\u4ee3\u7801\u5c42\u9762\u6784\u5efa\u4e86 MCP Server\u2014\u2014McpToolContributor SPI\u3001@Tool \u6ce8\u89e3\u3001SSE \u4f20\u8f93\u914d\u7f6e\u30012026-07-28 \u65e0\u72b6\u6001\u65b0\u89c4\u8303<\/li>\n
- MCP-03 \u5de5\u7a0b\u5316\u5b9e\u6218：\u4ee5 Dream-SaaS \u771f\u5b9e\u4ee3\u7801\u4e3a\u4e3b\u7ebf，\u89e3\u51b3\u4e86\u591a Server \u7f16\u6392\u3001\u53ef\u89c2\u6d4b\u6027\u3001\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406\u4e09\u5927\u751f\u4ea7\u7ea7\u95ee\u9898<\/li>\n<\/ul>\n
\u4e0b\u4e00\u7bc7\u6211\u4eec\u5c06\u8df3\u51fa MCP \u7684\u5de5\u5177\u8c03\u7528\u8303\u7574，\u8fdb\u5165 Agent \u8bb0\u5fc6\u7cfb\u7edf（#05）\u2014\u2014Agent \u600e\u4e48\u8bb0\u4f4f\u4e0a\u4e0b\u6587\u3001\u600e\u4e48\u79ef\u7d2f\u957f\u671f\u77e5\u8bc6\u3001\u600e\u4e48\u5728\u5bf9\u8bdd\u4e2d\u5b9e\u73b0"\u771f\u6b63\u7684\u7406\u89e3"\u800c\u975e\u6bcf\u6b21\u90fd\u4ece\u96f6\u5f00\u59cb\u3002<\/p>\n \u2014 \u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 \u00b7 \u7b2c 3 \u7bc7 \u2014<\/p>\n \u6709\u95ee\u9898\u8bc4\u8bba\u533a\u89c1，\u6b22\u8fce\u4ea4\u6d41~<\/p>\n","protected":false},"excerpt":{"rendered":" \u534f\u8bae\u89e3\u51b3\u7684\u662f\\”\u600e\u4e48\u5bf9\u8bdd\\”，\u5de5\u7a0b\u5316\u89e3\u51b3\u7684\u662f\\”\u600e\u4e48\u5728\u751f\u4ea7\u73af\u5883\u7a33\u5b9a\u5730\u5bf9\u8bdd\\”\u3002 \u524d\u4e00\u7bc7\u6211\u4eec\u7528 Spring AI \u642d\u5efa\u4e86\u4e00\u4e2a\u529f\u80fd\u5b8c\u6574\u7684 MCP Server，\/mcp\/sse \u7aef\u70b9\u80fd\u6b63\u5e38\u54cd\u5e94，\u5de5\u5177\u80fd\u88ab Client \u53d1\u73b0\u548c\u8c03\u7528\u3002\u4f46\u5f53\u4f60\u8bd5\u56fe\u628a\u8fd9\u4e2a\u7cfb\u7edf\u90e8\u7f72\u5230\u751f\u4ea7\u73af\u5883\u65f6，\u95ee\u9898\u4f1a\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5192\u51fa\u6765：\u8fde\u63a5\u54ea\u4e9b Server？\u914d\u7f6e\u6563\u843d\u5728\u54ea\u91cc？\u4e00\u6b21\u8bf7\u6c42\u7ecf\u8fc7\u4e86\u51e0\u6b21 tool call？\u8017\u65f6\u591a<\/p>\n","protected":false},"author":2,"featured_media":94335,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[10187,50],"topic":[],"class_list":["post-94336","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-server","tag-codingplan","tag-50"],"yoast_head":"\n \u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wsisp.com\/helps\/94336.html\" \/>\n<meta property=\"og:locale\" content=\"zh_CN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"og:description\" content=\"\u534f\u8bae\u89e3\u51b3\u7684\u662f"\u600e\u4e48\u5bf9\u8bdd"，\u5de5\u7a0b\u5316\u89e3\u51b3\u7684\u662f"\u600e\u4e48\u5728\u751f\u4ea7\u73af\u5883\u7a33\u5b9a\u5730\u5bf9\u8bdd"\u3002 \u524d\u4e00\u7bc7\u6211\u4eec\u7528 Spring AI \u642d\u5efa\u4e86\u4e00\u4e2a\u529f\u80fd\u5b8c\u6574\u7684 MCP Server，\/mcp\/sse \u7aef\u70b9\u80fd\u6b63\u5e38\u54cd\u5e94，\u5de5\u5177\u80fd\u88ab Client \u53d1\u73b0\u548c\u8c03\u7528\u3002\u4f46\u5f53\u4f60\u8bd5\u56fe\u628a\u8fd9\u4e2a\u7cfb\u7edf\u90e8\u7f72\u5230\u751f\u4ea7\u73af\u5883\u65f6，\u95ee\u9898\u4f1a\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5192\u51fa\u6765：\u8fde\u63a5\u54ea\u4e9b Server？\u914d\u7f6e\u6563\u843d\u5728\u54ea\u91cc？\u4e00\u6b21\u8bf7\u6c42\u7ecf\u8fc7\u4e86\u51e0\u6b21 tool call？\u8017\u65f6\u591a\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wsisp.com\/helps\/94336.html\" \/>\n<meta property=\"og:site_name\" content=\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\" \/>\n<meta property=\"article:published_time\" content=\"2026-08-14T02:18:32+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814021825-6a7e7af19f586.jpg\" \/>\n<meta name=\"author\" content=\"admin\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u4f5c\u8005\" \/>\n\t<meta name=\"twitter:data1\" content=\"admin\" \/>\n\t<meta name=\"twitter:label2\" content=\"\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4\" \/>\n\t<meta name=\"twitter:data2\" content=\"14 \u5206\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/94336.html\",\"url\":\"https:\/\/www.wsisp.com\/helps\/94336.html\",\"name\":\"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"isPartOf\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\"},\"datePublished\":\"2026-08-14T02:18:32+00:00\",\"dateModified\":\"2026-08-14T02:18:32+00:00\",\"author\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.wsisp.com\/helps\/94336.html#breadcrumb\"},\"inLanguage\":\"zh-Hans\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wsisp.com\/helps\/94336.html\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/94336.html#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"\u9996\u9875\",\"item\":\"https:\/\/www.wsisp.com\/helps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#website\",\"url\":\"https:\/\/www.wsisp.com\/helps\/\",\"name\":\"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3\",\"description\":\"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"zh-Hans\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41\",\"name\":\"admin\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"zh-Hans\",\"@id\":\"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"contentUrl\":\"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery\",\"caption\":\"admin\"},\"sameAs\":[\"http:\/\/wp.wsisp.com\"],\"url\":\"https:\/\/www.wsisp.com\/helps\/author\/admin\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wsisp.com\/helps\/94336.html","og_locale":"zh_CN","og_type":"article","og_title":"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","og_description":"\u534f\u8bae\u89e3\u51b3\u7684\u662f\"\u600e\u4e48\u5bf9\u8bdd\"，\u5de5\u7a0b\u5316\u89e3\u51b3\u7684\u662f\"\u600e\u4e48\u5728\u751f\u4ea7\u73af\u5883\u7a33\u5b9a\u5730\u5bf9\u8bdd\"\u3002 \u524d\u4e00\u7bc7\u6211\u4eec\u7528 Spring AI \u642d\u5efa\u4e86\u4e00\u4e2a\u529f\u80fd\u5b8c\u6574\u7684 MCP Server，\/mcp\/sse \u7aef\u70b9\u80fd\u6b63\u5e38\u54cd\u5e94，\u5de5\u5177\u80fd\u88ab Client \u53d1\u73b0\u548c\u8c03\u7528\u3002\u4f46\u5f53\u4f60\u8bd5\u56fe\u628a\u8fd9\u4e2a\u7cfb\u7edf\u90e8\u7f72\u5230\u751f\u4ea7\u73af\u5883\u65f6，\u95ee\u9898\u4f1a\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5192\u51fa\u6765：\u8fde\u63a5\u54ea\u4e9b Server？\u914d\u7f6e\u6563\u843d\u5728\u54ea\u91cc？\u4e00\u6b21\u8bf7\u6c42\u7ecf\u8fc7\u4e86\u51e0\u6b21 tool call？\u8017\u65f6\u591a","og_url":"https:\/\/www.wsisp.com\/helps\/94336.html","og_site_name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","article_published_time":"2026-08-14T02:18:32+00:00","og_image":[{"url":"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814021825-6a7e7af19f586.jpg"}],"author":"admin","twitter_card":"summary_large_image","twitter_misc":{"\u4f5c\u8005":"admin","\u9884\u8ba1\u9605\u8bfb\u65f6\u95f4":"14 \u5206"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wsisp.com\/helps\/94336.html","url":"https:\/\/www.wsisp.com\/helps\/94336.html","name":"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406 - \u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","isPartOf":{"@id":"https:\/\/www.wsisp.com\/helps\/#website"},"datePublished":"2026-08-14T02:18:32+00:00","dateModified":"2026-08-14T02:18:32+00:00","author":{"@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41"},"breadcrumb":{"@id":"https:\/\/www.wsisp.com\/helps\/94336.html#breadcrumb"},"inLanguage":"zh-Hans","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wsisp.com\/helps\/94336.html"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wsisp.com\/helps\/94336.html#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"\u9996\u9875","item":"https:\/\/www.wsisp.com\/helps"},{"@type":"ListItem","position":2,"name":"\u6df1\u5165\u7406\u89e3 AI Agent \u00b7 MCP \u5b50\u7cfb\u5217 #03\uff1a\u591a Server \u7f16\u6392\u3001\u8c03\u7528\u94fe\u53ef\u89c2\u6d4b\u4e0e\u8fde\u63a5\u751f\u547d\u5468\u671f\u7ba1\u7406"}]},{"@type":"WebSite","@id":"https:\/\/www.wsisp.com\/helps\/#website","url":"https:\/\/www.wsisp.com\/helps\/","name":"\u7f51\u7855\u4e92\u8054\u5e2e\u52a9\u4e2d\u5fc3","description":"\u9999\u6e2f\u670d\u52a1\u5668_\u9999\u6e2f\u4e91\u670d\u52a1\u5668\u8d44\u8baf_\u670d\u52a1\u5668\u5e2e\u52a9\u6587\u6863_\u670d\u52a1\u5668\u6559\u7a0b","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wsisp.com\/helps\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"zh-Hans"},{"@type":"Person","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/358e386c577a3ab51c4493330a20ad41","name":"admin","image":{"@type":"ImageObject","inLanguage":"zh-Hans","@id":"https:\/\/www.wsisp.com\/helps\/#\/schema\/person\/image\/","url":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","contentUrl":"https:\/\/gravatar.wp-china-yes.net\/avatar\/?s=96&d=mystery","caption":"admin"},"sameAs":["http:\/\/wp.wsisp.com"],"url":"https:\/\/www.wsisp.com\/helps\/author\/admin"}]}},"_links":{"self":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/94336","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/comments?post=94336"}],"version-history":[{"count":0,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/posts\/94336\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media\/94335"}],"wp:attachment":[{"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/media?parent=94336"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/categories?post=94336"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/tags?post=94336"},{"taxonomy":"topic","embeddable":true,"href":"https:\/\/www.wsisp.com\/helps\/wp-json\/wp\/v2\/topic?post=94336"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}} | |
![\"\"](\"https:\/\/www.wsisp.com\/helps\/wp-content\/uploads\/2026\/08\/20260814021825-6a7e7af19f586.jpg\")
<\/h2>\n