1"use strict";(self.webpackChunkspring_ai_alibaba_website=self.webpackChunkspring_ai_alibaba_website||[]).push([[1776],{28453:(e,n,s)=>{s.d(n,{R:()=>c,x:()=>t});var i=s(96540);const r={},l=i.createContext(r);function c(e){const n=i.useContext(l);return i.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function t(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:c(e.components),i.createElement(l.Provider,{value:n},e.children)}},81552:(e,n,s)=>{s.r(n),s.d(n,{assets:()=>d,contentTitle:()=>t,default:()=>a,frontMatter:()=>c,metadata:()=>i,toc:()=>o});const i=JSON.parse('{"id":"mcps/examples/mcp-client","title":"MCP Client Starter","description":"Spring AI MCP\uff08\u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae\uff09Client Starter \u4e3a Spring Boot \u5e94\u7528\u7a0b\u5e8f\u4e2d\u7684 MCP \u5ba2\u6237\u7aef\u529f\u80fd\u63d0\u4f9b\u81ea\u52a8\u914d\u7f6e\u3002\u5b83\u652f\u6301\u540c\u6b65\u548c\u5f02\u6b65\u5ba2\u6237\u7aef\u5b9e\u73b0\uff0c\u5e76\u63d0\u4f9b\u591a\u79cd\u4f20\u8f93\u9009\u9879\u3002","source":"@site/integration/mcps/examples/mcp-client.md","sourceDirName":"mcps/examples","slug":"/mcps/examples/mcp-client","permalink":"/integration/mcps/examples/mcp-client","draft":false,"unlisted":false,"editUrl":"https://github.com/spring-ai-alibaba/website/tree/main/integration/mcps/examples/mcp-client.md","tags":[],"version":"current","lastUpdatedBy":"Ken Liu","lastUpdatedAt":1765761850000,"sidebarPosition":8,"frontMatter":{"sidebar_position":8},"sidebar":"integrationSidebar","previous":{"title":"Model Context Protocol\uff08MCP\uff09\u6982\u89c8","permalink":"/integration/mcps/examples/mcp"},"next":{"title":"MCP Server Starter","permalink":"/integration/mcps/examples/mcp-server"}}');var r=s(74848),l=s(28453);const c={sidebar_position:8},t="MCP Client Starter",d={},o=[{value:"Client Starter",id:"client-starter",level:3},{value:"\u6807\u51c6 MCP Client",id:"\u6807\u51c6-mcp-client",level:4},{value:"WebFlux Client",id:"webflux-client",level:4},{value:"\u901a\u7528\u5c5e\u6027",id:"\u901a\u7528\u5c5e\u6027",level:5},{value:"Stdio Transport Properties",id:"stdio-transport-properties",level:5},{value:"SSE \u4f20\u8f93\u5c5e\u6027",id:"sse-\u4f20\u8f93\u5c5e\u6027",level:4},{value:"\u7279\u6027",id:"\u7279\u6027",level:3},{value:"\u540c\u6b65/\u5f02\u6b65\u5ba2\u6237\u7aef\u7c7b\u578b",id:"\u540c\u6b65\u5f02\u6b65\u5ba2\u6237\u7aef\u7c7b\u578b",level:4},{value:"\u5ba2\u6237\u7aef\u81ea\u5b9a\u4e49",id:"\u5ba2\u6237\u7aef\u81ea\u5b9a\u4e49",level:4},{value:"\u81ea\u5b9a\u4e49\u7c7b\u578b",id:"\u81ea\u5b9a\u4e49\u7c7b\u578b",level:5},{value:"\u540c\u6b65\u4ee3\u7801\u793a\u4f8b\uff1a",id:"\u540c\u6b65\u4ee3\u7801\u793a\u4f8b",level:6},{value:"\u5f02\u6b65\u4ee3\u7801\u793a\u4f8b\uff1a",id:"\u5f02\u6b65\u4ee3\u7801\u793a\u4f8b",level:6},{value:"\u4f20\u8f93\u652f\u6301",id:"\u4f20\u8f93\u652f\u6301",level:4},{value:"\u4e0e Spring AI \u96c6\u6210",id:"\u4e0e-spring-ai-\u96c6\u6210",level:4},{value:"\u4f7f\u7528\u793a\u4f8b",id:"\u4f7f\u7528\u793a\u4f8b",level:3}];function h(e){const n={a:"a",blockquote:"blockquote",code:"code",h1:"h1",h3:"h3",h4:"h4",h5:"h5",h6:"h6",header:"header",li:"li",p:"p",pre:"pre",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,l.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(n.header,{children:(0,r.jsx)(n.h1,{id:"mcp-client-starter",children:"MCP Client Starter"})}),"\n",(0,r.jsx)(n.p,{children:"Spring AI MCP\uff08\u6a21\u578b\u4e0a\u4e0b\u6587\u534f\u8bae\uff09Client Starter \u4e3a Spring Boot \u5e94\u7528\u7a0b\u5e8f\u4e2d\u7684 MCP \u5ba2\u6237\u7aef\u529f\u80fd\u63d0\u4f9b\u81ea\u52a8\u914d\u7f6e\u3002\u5b83\u652f\u6301\u540c\u6b65\u548c\u5f02\u6b65\u5ba2\u6237\u7aef\u5b9e\u73b0\uff0c\u5e76\u63d0\u4f9b\u591a\u79cd\u4f20\u8f93\u9009\u9879\u3002"}),"\n",(0,r.jsx)(n.p,{children:"MCP Client Starter \u63d0\u4f9b\uff1a"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u591a\u4e2a\u5ba2\u6237\u7aef\u5b9e\u4f8b\u7684\u7ba1\u7406"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u81ea\u52a8\u5ba2\u6237\u7aef\u521d\u59cb\u5316\uff08\u5982\u679c\u542f\u7528\uff09"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u652f\u6301\u591a\u4e2a\u547d\u540d\u4f20\u8f93"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u4e0e Spring AI \u7684\u5de5\u5177\u6267\u884c\u6846\u67b6\u96c6\u62
110"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u9002\u5f53\u7684\u751f\u547d\u5468\u671f\u7ba1\u7406\uff0c\u5728\u5e94\u7528\u7a0b\u5e8f\u4e0a\u4e0b\u6587\u5173\u95ed\u65f6\u81ea\u52a8\u6e05\u7406\u8d44\u6e90"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u901a\u8fc7\u81ea\u5b9a\u4e49\u5668\u5b9e\u73b0\u53ef\u81ea\u5b9a\u4e49\u7684\u5ba2\u6237\u7aef\u521b\u5efa"}),"\n"]}),"\n"]}),"\n",(0,r.jsx)(n.h3,{id:"client-starter",children:"Client Starter"}),"\n",(0,r.jsxs)(n.blockquote,{children:["\n",(0,r.jsxs)(n.p,{children:["Spring AI \u81ea\u52a8\u914d\u7f6e\u548c Client Starter \u6a21\u5757\u7684\u6784\u4ef6\u540d\u79f0\u53d1\u751f\u4e86\u91cd\u5927\u53d8\u5316\u3002 \u8bf7\u53c2\u9605 ",(0,r.jsx)(n.a,{href:"https://docs.spring.io/spring-ai/reference/upgrade-notes.html",children:"\u5347\u7ea7\u8bf4\u660e"})," \u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002"]}),"\n"]}),"\n",(0,r.jsx)(n.h4,{id:"\u6807\u51c6-mcp-client",children:"\u6807\u51c6 MCP Client"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-xml",children:"<dependency>\n <groupId>org.springframework.ai</groupId>\n <artifactId>spring-ai-starter-mcp-client</artifactId>\n</dependency>\n"})}),"\n",(0,r.jsxs)(n.p,{children:["\u6807\u51c6 Client Starter \u901a\u8fc7 ",(0,r.jsx)(n.code,{children:"STDIO"}),"\uff08\u8fdb\u7a0b\u5185\uff09\u548c/\u6216 ",(0,r.jsx)(n.code,{children:"SSE"}),"\uff08\u8fdc\u7a0b\uff09\u4f20\u8f93\u540c\u65f6\u8fde\u63a5\u5230\u4e00\u4e2a\u6216\u591a\u4e2a ",(0,r.jsx)(n.code,{children:"MCP"})," \u670d\u52a1\u5668\u3002 ",(0,r.jsx)(n.code,{children:"SSE"})," \u8fde\u63a5\u4f7f\u7528\u57fa\u4e8e HttpClient \u7684\u4f20\u8f93\u5b9e\u73b0\u3002 \u6bcf\u4e2a\u5230 MCP \u670d\u52a1\u5668\u7684\u8fde\u63a5\u90fd\u4f1a\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 MCP \u5ba2\u6237\u7aef\u5b9e\u4f8b\u3002 \u60a8\u53ef\u4ee5\u9009\u62e9 ",(0,r.jsx)(n.code,{children:"SYNC"})," \u6216 ",(0,r.jsx)(n.code,{children:"ASYNC"})," MCP \u5ba2\u6237\u7aef\uff08\u6ce8\u610f\uff1a\u4e0d\u80fd\u6df7\u5408\u4f7f\u7528\u540c\u6b65\u548c\u5f02\u6b65\u5ba2\u6237\u7aef\uff09\u3002 \u5bf9\u4e8e\u751f\u4ea7\u90e8\u7f72\uff0c\u6211\u4eec\u5efa\u8bae\u4f7f\u7528\u57fa\u4e8e WebFlux \u7684 SSE \u8fde\u63a5\uff0c\u5373 ",(0,r.jsx)(n.code,{children:"spring-ai-starter-mcp-client-webflux"}),"\u3002"]}),"\n",(0,r.jsx)(n.h4,{id:"webflux-client",children:"WebFlux Client"}),"\n",(0,r.jsx)(n.h5,{id:"\u901a\u7528\u5c5e\u6027",children:"\u901a\u7528\u5c5e\u6027"}),"\n",(0,r.jsxs)(n.p,{children:["\u901a\u7528\u5c5e\u6027\u4ee5 ",(0,r.jsx)(n.code,{children:"spring.ai.mcp.client"})," \u4e3a\u524d\u7f00\uff0cClient Starter \u63d0\u4f9b\uff1a"]}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"\u5c5e\u6027"}),(0,r.jsx)(n.th,{children:"\u63cf\u8ff0"}),(0,r.jsx)(n.th,{children:"\u9ed8\u8ba4\u503c"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"enabled"})}),(0,r.jsx)(n.td,{children:"\u542f\u7528/\u7981\u7528 MCP Client"}),(0,r.jsx)(n.td,{children:"true"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"name"})}),(0,r.jsx)(n.td,{children:"MCP Client \u5b9e\u4f8b\u7684\u540d\u79f0\uff08\u7528\u4e8e\u517c\u5bb9\u6027\u68c0\u67e5\uff09"}),(0,r.jsx)(n.td,{children:"spring-ai-mcp-client"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"version"})}),(0,r.jsx)(n.td,{children:"MCP Client \u5b9e\u4f8b\u7684\u7248\u672c"}),(0,r.jsx)(n.td,{children:"1.0.0"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"initialized"})}),(0,r.jsx)(n.td,{children:"\u662f\u5426\u5728\u521b\u5efa\u65f6\u521d\u59cb\u5316 Client"}),(0,r.jsx)(n.td,{children:"true"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"request-timeout"})}),(0,r.jsx)(n.td,{children:"MCP Client \u8bf7\u6c42\u7684\u8d85\u65f6\u65f6\u95f4"}),(0,r.jsx)(n.td,{children:"20s"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"type"})}),(0,r.jsx)(n.td,{children:"Client \u7c7b\u578b\uff08SYNC \u6216 ASYNC\uff09\u3002\u6240\u6709 Client \u5fc5\u987b\u662f\u540c\u6b65\u6216\u5f02\u6b65\u7684\uff1b\u4e0
1d\u652f\u6301\u6df7\u5408\u4f7f\u7528"}),(0,r.jsx)(n.td,{children:"SYNC"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"root-change-notification"})}),(0,r.jsx)(n.td,{children:"\u4e3a\u6240\u6709 Client \u542f\u7528/\u7981\u7528\u6839\u53d8\u66f4\u901a\u77e5"}),(0,r.jsx)(n.td,{children:"true"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"toolcallback.enabled"})}),(0,r.jsx)(n.td,{children:"\u542f\u7528/\u7981\u7528 MCP \u5de5\u5177\u56de\u8c03\u4e0e Spring AI \u5de5\u5177\u6267\u884c\u6846\u67b6\u7684\u96c6\u6210"}),(0,r.jsx)(n.td,{children:"true"})]})]})]}),"\n",(0,r.jsx)(n.h5,{id:"stdio-transport-properties",children:"Stdio Transport Properties"}),"\n",(0,r.jsxs)(n.p,{children:["\u6807\u51c6 I/O \u4f20\u8f93\u7684\u5c5e\u6027\u4ee5 ",(0,r.jsx)(n.code,{children:"spring.ai.mcp.client.stdio"})," \u4e3a\u524d\u7f00\uff0cClient Starter \u63d0\u4f9b\uff1a"]}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"\u5c5e\u6027"}),(0,r.jsx)(n.th,{children:"\u63cf\u8ff0"}),(0,r.jsx)(n.th,{children:"\u9ed8\u8ba4\u503c"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"servers-configuration"})}),(0,r.jsx)(n.td,{children:"\u5305\u542b MCP \u670d\u52a1\u5668\u914d\u7f6e\u7684 JSON \u683c\u5f0f\u8d44\u6e90"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections"})}),(0,r.jsx)(n.td,{children:"\u547d\u540d stdio \u8fde\u63a5\u914d\u7f6e\u7684\u6620\u5c04"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections.[name].command"})}),(0,r.jsx)(n.td,{children:"\u8981\u6267\u884c\u7684 MCP \u670d\u52a1\u5668\u547d\u4ee4"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections.[name].args"})}),(0,r.jsx)(n.td,{children:"\u547d\u4ee4\u53c2\u6570\u5217\u8868"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections.[name].env"})}),(0,r.jsx)(n.td,{children:"\u670d\u52a1\u5668\u8fdb\u7a0b\u7684\u73af\u5883\u53d8\u91cf\u6620\u5c04"}),(0,r.jsx)(n.td,{children:"-"})]})]})]}),"\n",(0,r.jsx)(n.p,{children:"\u914d\u7f6e\u793a\u4f8b\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:'spring:\n ai:\n mcp:\n client:\n stdio:\n root-change-notification: true\n connections:\n server1:\n command: /path/to/server\n args:\n - --port=8080\n - --mode=production\n env:\n API_KEY: your-api-key\n DEBUG: "true"\n'})}),"\n",(0,r.jsxs)(n.p,{children:["\u6216\u8005\uff0c\u60a8\u53ef\u4ee5\u4f7f\u7528\u5916\u90e8 JSON \u6587\u4ef6\u914d\u7f6e stdio \u8fde\u63a5\uff0c\u4f7f\u7528 ",(0,r.jsx)(n.a,{href:"https://modelcontextprotocol.io/quickstart/user",children:"Claude Desktop \u683c\u5f0f"}),"\uff1a"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:"spring:\n ai:\n mcp:\n client:\n stdio:\n servers-configuration: classpath:mcp-servers.json\n"})}),"\n",(0,r.jsx)(n.p,{children:"Claude Desktop \u683c\u5f0f\u5982\u4e0b\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:'{\n "mcpServers": {\n "filesystem": {\n "command": "npx",\n "args": [\n "-y",\n "@modelcontextprotocol/server-filesystem",\n "/Users/username/Desktop",\n "/Users/username/Downloads"\n ]\n }\n }\n}\n'})}),"\n",(0,r.jsx)(n.p,{children:"\u76ee\u524d\uff0cClaude Desktop \u683c\u5f0f\u4ec5\u652f\u6301 STDIO \u8fde\u63a5\u7c7b\u578b\u3002"}),"\n",(0,r.jsx)(n.h4,{id:"sse-\u4f20\u8f93\u5c5e\u6027",children:"SSE \u4f20\u8f93\u5c5e\u6027"}),"\n",(0,r.jsxs)(n.p,{children:["\u670d\u52a1\u5668\u53d1\u9001\u4e8b\u4ef6\uff08SSE\uff09\u4f20\u8f93\u7684\u5c5e\u6027\u4ee5 ",(0,r.jsx)(n.code,{children:"spring.ai.mcp.client.sse"})," \u4e3a\u524d\u7f00\uff1a"]}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"\u5c5e\u6027"}),(0,r.jsx)(n.th,{children:"\u63cf\u8ff0"}),(0,r.jsx)(n.th,{children:"\u9ed8\u8ba4\u503c"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections"})}
1),(0,r.jsx)(n.td,{children:"\u547d\u540d SSE \u8fde\u63a5\u914d\u7f6e\u7684\u6620\u5c04"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections.[name].url"})}),(0,r.jsx)(n.td,{children:"\u4e0e MCP \u670d\u52a1\u5668\u8fdb\u884c SSE \u901a\u4fe1\u7684\u57fa\u672c URL \u7aef\u70b9"}),(0,r.jsx)(n.td,{children:"-"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"connections.[name].sse-endpoint"})}),(0,r.jsx)(n.td,{children:"\u7528\u4e8e\u8fde\u63a5\u7684 sse \u7aef\u70b9\uff08\u4f5c\u4e3a url \u540e\u7f00\uff09"}),(0,r.jsx)(n.td,{children:"/sse"})]})]})]}),"\n",(0,r.jsx)(n.p,{children:"\u914d\u7f6e\u793a\u4f8b\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:"spring:\n ai:\n mcp:\n client:\n sse:\n connections:\n server1:\n url: http://localhost:8080\n server2:\n url: http://otherserver:8081\n sse-endpoint: /custom-sse\n"})}),"\n",(0,r.jsx)(n.h3,{id:"\u7279\u6027",children:"\u7279\u6027"}),"\n",(0,r.jsx)(n.h4,{id:"\u540c\u6b65\u5f02\u6b65\u5ba2\u6237\u7aef\u7c7b\u578b",children:"\u540c\u6b65/\u5f02\u6b65\u5ba2\u6237\u7aef\u7c7b\u578b"}),"\n",(0,r.jsx)(n.p,{children:"Starter \u652f\u6301\u4e24\u79cd\u7c7b\u578b\u7684\u5ba2\u6237\u7aef\uff1a"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u540c\u6b65 - \u9ed8\u8ba4\u5ba2\u6237\u7aef\u7c7b\u578b\uff0c\u9002\u7528\u4e8e\u5177\u6709\u963b\u585e\u64cd\u4f5c\u7684\u4f20\u7edf\u8bf7\u6c42-\u54cd\u5e94\u6a21\u5f0f"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:["\u5f02\u6b65 - \u9002\u7528\u4e8e\u5177\u6709\u975e\u963b\u585e\u64cd\u4f5c\u7684\u53cd\u5e94\u5f0f\u5e94\u7528\u7a0b\u5e8f\uff0c\u4f7f\u7528 ",(0,r.jsx)(n.code,{children:"spring.ai.mcp.client.type=ASYNC"})," \u914d\u7f6e"]}),"\n"]}),"\n"]}),"\n",(0,r.jsx)(n.h4,{id:"\u5ba2\u6237\u7aef\u81ea\u5b9a\u4e49",children:"\u5ba2\u6237\u7aef\u81ea\u5b9a\u4e49"}),"\n",(0,r.jsx)(n.p,{children:"\u81ea\u52a8\u914d\u7f6e\u901a\u8fc7\u56de\u8c03\u63a5\u53e3\u63d0\u4f9b\u5e7f\u6cdb\u7684\u5ba2\u6237\u7aef\u89c4\u8303\u81ea\u5b9a\u4e49\u529f\u80fd\u3002\u8fd9\u4e9b\u81ea\u5b9a\u4e49\u5668\u5141\u8bb8\u60a8\u914d\u7f6e MCP \u5ba2\u6237\u7aef\u884c\u4e3a\u7684\u5404\u4e2a\u65b9\u9762\uff0c\u4ece\u8bf7\u6c42\u8d85\u65f6\u5230\u4e8b\u4ef6\u5904\u7406\u548c\u6d88\u606f\u5904\u7406\u3002"}),"\n",(0,r.jsx)(n.h5,{id:"\u81ea\u5b9a\u4e49\u7c7b\u578b",children:"\u81ea\u5b9a\u4e49\u7c7b\u578b"}),"\n",(0,r.jsx)(n.p,{children:"\u4ee5\u4e0b\u81ea\u5b9a\u4e49\u9009\u9879\u53ef\u7528\uff1a"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u8bf7\u6c42\u914d\u7f6e - \u8bbe\u7f6e\u81ea\u5b9a\u4e49\u8bf7\u6c42\u8d85\u65f6"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u81ea\u5b9a\u4e49\u91c7\u6837\u5904\u7406\u5668 - \u670d\u52a1\u5668\u901a\u8fc7\u5ba2\u6237\u7aef\u4ece LLM \u8bf7\u6c42 LLM \u91c7\u6837\uff08completions \u6216 generations\uff09\u7684\u6807\u51c6\u5316\u65b9\u5f0f\u3002\u6b64\u6d41\u7a0b\u5141\u8bb8\u5ba2\u6237\u7aef\u4fdd\u6301\u5bf9\u6a21\u578b\u8bbf\u95ee\u3001\u9009\u62e9\u548c\u6743\u9650\u7684\u63a7\u5236\uff0c\u540c\u65f6\u4f7f\u670d\u52a1\u5668\u80fd\u591f\u5229\u7528 AI \u529f\u80fd \u2014 \u65e0\u9700\u670d\u52a1\u5668 API \u5bc6\u94a5\u3002"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u6587\u4ef6\u7cfb\u7edf\uff08\u6839\uff09\u8bbf\u95ee - \u5ba2\u6237\u7aef\u5411\u670d\u52a1\u5668\u516c\u5f00\u6587\u4ef6\u7cfb\u7edf roots \u7684\u6807\u51c6\u5316\u65b9\u5f0f\u3002 Roots \u5b9a\u4e49\u4e86\u670d\u52a1\u5668\u53ef\u4ee5\u5728\u6587\u4ef6\u7cfb\u7edf\u4e2d\u64cd\u4f5c\u7684\u8fb9\u754c\uff0c\u5141\u8bb8\u5b83\u4eec\u4e86\u89e3\u53ef\u4ee5\u8bbf\u95ee\u54ea\u4e9b\u76ee\u5f55\u548c\u6587\u4ef6\u3002 \u670d\u52a1\u5668\u53ef\u4ee5\u4ece\u652f\u6301\u6839\u53d8\u66f4\u7684\u5ba2\u6237\u7aef\u8bf7\u6c42\u6839\u5217\u8868\uff0c\u5e76\u5728\u8be5\u5217\u8868\u66f4\u6539\u65f6\u63a5\u6536\u901a\u77e5\u3002"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u4e8b\u4ef6\u5904\u7406\u5668 - \u5f53\u53d1\u751f\u7279\u5b9a\u670d\u52a1\u5668\u4e8b\u4ef6\u65f6\u901a\u77e5\u5ba2\u6237\u7aef\u7684\u5904\u7406\u5668\uff1a"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u5de5\u5177\u53d8\u66f4\u901a\u77e5 - \u5f53\u53ef\u7528\u670d\u52a1\u5668\u5de5\u5177\u5217\u8868\u66f4\u6539\u65f6"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u8d44\u6e90\u53d8\u66f4\u901a\u77e5 - \u5f53\u53ef\u7528\u670d\u52a1\u5668\u8d44\u6e90\u5217\u8868\u66f4\u6539\u65f6"}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u63d0\u793a\u53d8\u66f4\u901a\u77e5 - \u5f53\u53ef\u7528\u670d\u52a1\u5668\u63d0\u793a\u5217\u8868\u66f4\u6539\u65f6"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsx)(n.p,{children:"\u65e5\u5fd7\u5904\u7406\u5668 - \u670d\u52a1\u5668\u5411\u5ba2\u6237\u7aef\u53d1\u9001\u7ed3\u6784\u5316\u65e5\u5fd7\u6d88\u606f\u7684\u6807\u51c6\u5316\u65b9\u5f0f\u3002 \u5ba2\u6237\u7aef\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e\u6700\u5c0f\u65e5\u5fd7\u7ea7\u522b\u6765\u63a7\u5236\u65e5\u5fd7\u8be6\u7ec6\u7a0b\u5ea6"}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["\u60a8\u53ef\u4ee5\u6839\u636e\u5e94\u7528\u7a0b\u5e8f\u7684\u9700\u6c42\u5b9e\u73b0 ",(0,r.jsx)(n.code,{children:"McpSyncClientCustomizer"})," \u7528\u4e8e\u540c\u6b65\u5ba2\u6237\u7aef\uff0c\u6216 ",(0,r.jsx)(n.code,{children:"McpAsyncClientCustomizer"})," \u7528\u4e8e\u5f02\u6b65\u5ba2\u6237\u7aef\u3002"]}),"\n",(0,r.jsx)(n.h6,{id:"\u540c\u6b65\u4ee3\u7801\u793a\u4f8b",children:"\u540c\u6b65\u4ee3\u7801\u793a\u4f8b\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-java",children:"@Component\npublic class CustomMcpSyncClientCustomizer implements McpSyncClientCustomizer {\n @Override\n public void customize(String serverConfigurationName, McpClient.SyncSpec spec) {\n\n // \u81ea\u5b9a\u4e49\u8bf7\u6c42\u8d85\u65f6\u914d\u7f6e\n spec.requestTimeout(Duration.ofSeconds(30));\n\n // \u8bbe\u7f6e\u6b64\u5ba2\u6237\u7aef\u53ef\u4ee5\u8bbf\u95ee\u7684\u6839 URI\u3002\n spec.roots(roots);\n\n // \u8bbe\u7f6e\u7528\u4e8e\u5904\u7406\u6d88\u606f\u521b\u5efa\u8bf7\u6c42\u7684\u81ea\u5b9a\u4e49\u91c7\u6837\u5904\u7406\u5668\u3002\n spec.sampling((CreateMessageRequest messageRequest) -> {\n // \u5904\u7406\u91c7\u6837\n CreateMessageResult result = ...\n return result;\n });\n\n // \u6dfb\u52a0\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u5728\u53ef\u7528\u5de5\u5177\u66f4\u6539\u65f6\uff08\u4f8b\u5982\u6dfb\u52a0\u6216\u5220\u9664\u5de5\u5177\uff09\u901a\u77e5\u3002\n spec.toolsChangeConsumer((List<McpSchema.Tool> tools) -> {\n // \u5904\u7406\u5de5\u5177\u53d8\u66f4\n });\n\n // \u6dfb\u52a0\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u5728\u53ef\u7528\u8d44\u6e90\u66f4\u6539\u65f6\uff08\u4f8b\u5982\u6dfb\u52a0\u6216\u5220\u9664\u8d44\u6e90\uff09\u901a\u77e5\u3002\n spec.resourcesChangeConsumer((List<McpSchema.Resource> resources) ->
1 {\n // \u5904\u7406\u8d44\u6e90\u53d8\u66f4\n });\n\n // \u6dfb\u52a0\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u5728\u53ef\u7528\u63d0\u793a\u66f4\u6539\u65f6\uff08\u4f8b\u5982\u6dfb\u52a0\u6216\u5220\u9664\u63d0\u793a\uff09\u901a\u77e5\u3002\n spec.promptsChangeConsumer((List<McpSchema.Prompt> prompts) -> {\n // \u5904\u7406\u63d0\u793a\u53d8\u66f4\n });\n\n // \u6dfb\u52a0\u4e00\u4e2a\u6d88\u8d39\u8005\uff0c\u5728\u4ece\u670d\u52a1\u5668\u63a5\u6536\u65e5\u5fd7\u6d88\u606f\u65f6\u901a\u77e5\u3002\n spec.loggingConsumer((McpSchema.LoggingMessageNotification log) -> {\n // \u5904\u7406\u65e5\u5fd7\u6d88\u606f\n });\n }\n}\n"})}),"\n",(0,r.jsx)(n.h6,{id:"\u5f02\u6b65\u4ee3\u7801\u793a\u4f8b",children:"\u5f02\u6b65\u4ee3\u7801\u793a\u4f8b\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-java",children:"@Component\npublic class CustomMcpAsyncClientCustomizer implements McpAsyncClientCustomizer {\n @Override\n public void customize(String serverConfigurationName, McpClient.AsyncSpec spec) {\n // \u81ea\u5b9a\u4e49\u5f02\u6b65\u5ba2\u6237\u7aef\u914d\u7f6e\n spec.requestTimeout(Duration.ofSeconds(30));\n }\n}\n"})}),"\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"serverConfigurationName"})," \u53c2\u6570\u662f\u6b63\u5728\u5e94\u7528\u81ea\u5b9a\u4e49\u5668\u7684\u670d\u52a1\u5668\u914d\u7f6e\u7684\u540d\u79f0\uff0cMCP \u5ba2\u6237\u7aef\u5c06\u4e3a\u5176\u521b\u5efa\u3002"]}),"\n",(0,r.jsx)(n.p,{children:"MCP \u5ba2\u6237\u7aef\u81ea\u52a8\u914d\u7f6e\u4f1a\u81ea\u52a8\u68c0\u6d4b\u5e76\u5e94\u7528\u5728\u5e94\u7528\u7a0b\u5e8f\u4e0a\u4e0b\u6587\u4e2d\u627e\u5230\u7684\u4efb\u4f55\u81ea\u5b9a\u4e49\u5668\u3002"}),"\n",(0,r.jsx)(n.h4,{id:"\u4f20\u8f93\u652f\u6301",children:"\u4f20\u8f93\u652f\u6301"}),"\n",(0,r.jsx)(n.p,{children:"\u81ea\u52a8\u914d\u7f6e\u652f\u6301\u591a\u79cd\u4f20\u8f93\u7c7b\u578b\uff1a"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:["\u6807\u51c6 I/O\uff08Stdio\uff09\uff08\u7531 ",(0,r.jsx)(n.code,{children:"spring-ai-starter-mcp-client"})," \u6fc0\u6d3b\uff09"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:["SSE HTTP\uff08\u7531 ",(0,r.jsx)(n.code,{children:"spring-ai-starter-mcp-client"})," \u6fc0\u6d3b\uff09"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:["SSE WebFlux\uff08\u7531 ",(0,r.jsx)(n.code,{children:"spring-ai-starter-mcp-client-webflux"})," \u6fc0\u6d3b\uff09"]}),"\n"]}),"\n"]}),"\n",(0,r.jsx)(n.h4,{id:"\u4e0e-spring-ai-\u96c6\u6210",children:"\u4e0e Spring AI \u96c6\u6210"}),"\n",(0,r.jsxs)(n.p,{children:["Starter \u53ef\u4ee5\u914d\u7f6e\u4e0e Spring AI \u5de5\u5177\u6267\u884c\u6846\u67b6\u96c6\u6210\u7684\u5de5\u5177\u56de\u8c03\uff0c\u5141\u8bb8 MCP \u5de5\u5177\u4f5c\u4e3a AI \u4ea4\u4e92\u7684\u4e00\u90e8\u5206\u4f7f\u7528\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u542f\u7528\u6b64\u96c6\u62
110\uff0c\u53ef\u4ee5\u901a\u8fc7\u8bbe\u7f6e ",(0,r.jsx)(n.code,{children:"spring.ai.mcp.client.toolcallback.enabled=false"})," \u5c5e\u6027\u6765\u7981\u7528\u3002"]}),"\n",(0,r.jsx)(n.h3,{id:"\u4f7f\u7528\u793a\u4f8b",children:"\u4f7f\u7528\u793a\u4f8b"}),"\n",(0,r.jsxs)(n.p,{children:["\u5c06\u9002\u5f53\u7684 Starter \u4f9d\u8d56\u9879\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\u4e2d\uff0c\u5e76\u5728 ",(0,r.jsx)(n.code,{children:"application.properties"})," \u6216 ",(0,r.jsx)(n.code,{children:"application.yml"})," \u4e2d\u914d\u7f6e\u5ba2\u6237\u7aef\uff1a"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-yaml",children:'spring:\n ai:\n mcp:\n client:\n enabled: true\n name: my-mcp-client\n version: 1.0.0\n request-timeout: 30s\n type: SYNC # \u6216 ASYNC \u7528\u4e8e\u53cd\u5e94\u5f0f\u5e94\u7528\u7a0b\u5e8f\n sse:\n connections:\n server1:\n url: http://localhost:8080\n server2:\n url: http://otherserver:8081\n stdio:\n root-change-notification: false\n connections:\n server1:\n command: /path/to/server\n args:\n - --port=8080\n - --mode=production\n env:\n API_KEY: your-api-key\n DEBUG: "true"\n'})}),"\n",(0,r.jsx)(n.p,{children:"MCP \u5ba2\u6237\u7aef bean \u5c06\u81ea\u52a8\u914d\u7f6e\u5e76\u53ef\u7528\u4e8e\u6ce8\u5165\uff1a"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-java",children:"@Autowired\nprivate List<McpSyncClient> mcpSyncClients; // \u7528\u4e8e\u540c\u6b65\u5ba2\u6237\u7aef\n\n// \u6216\n\n@Autowired\nprivate List<McpAsyncClient> mcpAsyncClients; // \u7528\u4e8e\u5f02\u6b65\u5ba2\u6237\u7aef\n"})}),"\n",(0,r.jsxs)(n.p,{children:["\u5f53\u542f\u7528\u5de5\u5177\u56de\u8c03\u65f6\uff08\u9ed8\u8ba4\u884c\u4e3a\uff09\uff0c\u6240\u6709 MCP \u5ba2\u6237\u7aef\u7684\u5df2\u6ce8\u518c MCP \u5de5\u5177\u90fd\u4f5c\u4e3a ",(0,r.jsx)(n.code,{children:"ToolCallbackProvider"})," \u5b9e\u4f8b\u63d0\u4f9b\uff1a"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-java",children:"@Autowired\nprivate SyncMcpToolCallbackProvider toolCallbackProvider;\nToolCallback[] toolCallbacks = toolCallbackProvider.getToolCallbacks();\n"})})]})}function a(e={}){const{wrapper:n}={...(0,l.R)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(h,{...e})}):h(e)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.