{"id":10021125,"date":"2025-12-17T22:44:09","date_gmt":"2025-12-17T14:44:09","guid":{"rendered":"https:\/\/itmax.cn\/?p=10021125"},"modified":"2025-12-17T22:44:09","modified_gmt":"2025-12-17T14:44:09","slug":"%e4%b8%8a%e4%b8%8b%e6%96%87%e5%8d%8f%e8%ae%ae%ef%bc%88mcp%ef%bc%89java-sdk-%e6%8c%87%e5%8d%97","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10021125","title":{"rendered":"\u4e0a\u4e0b\u6587\u534f\u8bae\uff08MCP\uff09Java SDK \u6307\u5357"},"content":{"rendered":"<p>\u5f53\u6211\u4eec\u628a\u5404\u79cd\u5185\u90e8\u7cfb\u7edf\u3001\u6570\u636e\u6e90\u3001\u5de5\u5177\u63a5\u5165\u5927\u8bed\u8a00\u6a21\u578b\u65f6\uff0c\u5f80\u5f80\u4f1a\u9047\u5230\u4e00\u4e2a\u5c34\u5c2c\u7684\u95ee\u9898\uff1a\u6bcf\u4e2a\u56e2\u961f\u3001\u6bcf\u5957\u7cfb\u7edf\u90fd\u6709\u81ea\u5df1\u7684\u4e00\u5957\u201c\u63a5\u5165\u89c4\u8303\u201d\u3002\u6709\u7684\u7528 HTTP API\uff0c\u6709\u7684\u7528\u6d88\u606f\u961f\u5217\uff0c\u6709\u7684\u76f4\u63a5\u8fde\u6570\u636e\u5e93\uff0c\u6700\u540e\u4e00\u5708\u4e32\u4e0b\u6765\uff0c\u65e2\u96be\u4ee5\u7edf\u4e00\u6cbb\u7406\uff0c\u53c8\u5f88\u96be\u5728\u4e0d\u540c\u5e94\u7528\u4e4b\u95f4\u590d\u7528\u3002\u8fd9\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u95ee\uff1a\u6709\u6ca1\u6709\u4e00\u79cd\u901a\u7528\u7684\u534f\u8bae\uff0c\u65e2\u80fd\u8ba9 AI \u6a21\u578b\u65b9\u4fbf\u5730\u8c03\u7528\u5916\u90e8\u5de5\u5177\u3001\u8bbf\u95ee\u6570\u636e\uff0c\u53c8\u80fd\u8ba9\u540e\u7aef\u670d\u52a1\u65b9\u7528\u6807\u51c6\u65b9\u5f0f\u66b4\u9732\u80fd\u529b\uff1f<\/p>\n<p>Model Context Protocol\uff08MCP\uff09\u5c31\u662f\u4e3a\u6b64\u800c\u751f\u7684\u6807\u51c6\u4e4b\u4e00\uff0c\u800c\u672c\u6587\u8981\u4ecb\u7ecd\u7684 Java SDK\uff0c\u5219\u4e3a Java \u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u4e00\u6761\u76f4\u63a5\u63a5\u5165 MCP \u751f\u6001\u7684\u901a\u8def\u3002\u901a\u8fc7\u5b83\uff0c\u4f60\u53ef\u4ee5\u7528\u7edf\u4e00\u7684\u6a21\u578b\uff0c\u5728 Java \u5e94\u7528\u91cc\u66b4\u9732\u5de5\u5177\u3001\u8d44\u6e90\u3001\u63d0\u793a\u6a21\u7248\uff0c\u4e5f\u53ef\u4ee5\u8f7b\u677e\u4f5c\u4e3a\u5ba2\u6237\u7aef\u53bb\u8c03\u7528\u8fd9\u4e9b\u80fd\u529b\u3002\u672c\u6587\u5c06\u4ece\u6574\u4f53\u67b6\u6784\u8bb2\u8d77\uff0c\u4e00\u6b65\u6b65\u5e26\u4f60\u7528\u4e00\u4e2a\u53ef\u8fd0\u884c\u7684\u793a\u4f8b\uff0c\u642d\u5efa\u8d77\u81ea\u5df1\u7684 MCP \u670d\u52a1\u7aef\u4e0e\u5ba2\u6237\u7aef\u3002<\/p>\n<h2>1. \u6982\u89c8<\/h2>\n<p>\u968f\u7740\u8fd1\u5e74\u6765 AI \u7684\u5feb\u901f\u53d1\u5c55\uff0c\u8d8a\u6765\u8d8a\u591a\u7684\u5de5\u5177\u548c\u7cfb\u7edf\u5f00\u59cb\u4e0e AI \u6a21\u578b\u96c6\u6210\u3002\u4f46\u968f\u4e4b\u800c\u6765\u7684\u4e00\u4e2a\u6311\u6218\u662f\uff1a\u6bcf\u79cd\u96c6\u6210\u90fd\u53ef\u80fd\u91c7\u7528\u5b8c\u5168\u4e0d\u540c\u7684\u6807\u51c6\u548c\u65b9\u5f0f\uff0c\u5c06\u5916\u90e8\u5de5\u5177\u3001\u8d44\u6e90\u548c\u7cfb\u7edf\u63a5\u5165\u5230 AI \u6a21\u578b\u4e2d\u3002<\/p>\n<p>Model Context Protocol\uff08MCP\uff09\u662f\u4e00\u4e2a\u5f00\u6e90\u6807\u51c6\uff0c\u5b83\u5b9a\u4e49\u4e86 AI \u5e94\u7528\uff08\u5982\u5927\u8bed\u8a00\u6a21\u578b\u3001\u56fe\u50cf\u751f\u6210\u6a21\u578b\u7b49\uff09\u4e0e\u5de5\u5177\u3001\u6570\u636e\u6e90\u4ee5\u53ca\u5176\u4ed6\u8d44\u6e90\u4e4b\u95f4\u7684\u96c6\u6210\u65b9\u5f0f\u3002\u501f\u52a9 MCP\uff0cAI \u5e94\u7528\u53ef\u4ee5\u6309\u5916\u90e8\u7cfb\u7edf\u7ea6\u5b9a\u7684\u65b9\u5f0f\u8bbf\u95ee\u6570\u636e\u3001\u8c03\u7528\u5de5\u5177\u5e76\u6267\u884c\u5de5\u4f5c\u6d41\u3002<\/p>\n<p>MCP \u7684 Java SDK \u4e3a\u5f00\u53d1\u8005\u63d0\u4f9b\u4e86\u4e00\u7ec4\u5e93\uff0c\u652f\u6301\u591a\u79cd\u534f\u8bae\u548c\u901a\u4fe1\u673a\u5236\uff0c\u7528\u4e8e\u628a Java \u5e94\u7528\u4e0e AI \u5e94\u7528\u8fde\u63a5\u8d77\u6765\u3002<\/p>\n<p>\u5728\u672c\u6559\u7a0b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e00\u8d77\u4e86\u89e3\u8fd9\u4e2a SDK\uff0c\u5e76\u901a\u8fc7\u4e00\u4e2a\u7b80\u5355\u793a\u4f8b\u6765\u4f53\u9a8c MCP \u7684\u4f7f\u7528\u65b9\u5f0f\u3002<\/p>\n<h2>2. \u67b6\u6784<\/h2>\n<p>MCP \u67b6\u6784\u7684\u6838\u5fc3\u7ec4\u4ef6\u4e3b\u8981\u5305\u62ec\uff1a<\/p>\n<ul>\n<li><strong>MCP Host\uff1a\u8d1f\u8d23\u7ba1\u7406\u591a\u4e2a MCP Client<\/strong><\/li>\n<li><strong>MCP Client\uff1a\u4ece MCP Server \u83b7\u53d6\u4e0a\u4e0b\u6587\uff0c\u4f9b MCP Host \u4f7f\u7528<\/strong><\/li>\n<li><strong>MCP Server\uff1a\u5411 MCP Client \u63d0\u4f9b\u4e0a\u4e0b\u6587\u4fe1\u606f\u548c\u53ef\u8c03\u7528\u80fd\u529b<\/strong><\/li>\n<\/ul>\n<p>MCP \u5c06\u901a\u4fe1\u5212\u5206\u4e3a\u4e24\u4e2a\u6982\u5ff5\u5c42\u6b21\uff1a<strong>\u6570\u636e\u5c42\uff08Data Layer\uff09\uff0c\u7528\u4e8e\u5b9a\u4e49\u5ba2\u6237\u7aef\u4e0e\u670d\u52a1\u7aef\u7684\u901a\u4fe1\u534f\u8bae\u548c\u751f\u547d\u5468\u671f\u7ba1\u7406<\/strong>\uff1b\u4ee5\u53ca <strong>\u4f20\u8f93\u5c42\uff08Transport Layer\uff09\uff0c\u7528\u4e8e\u5b9a\u4e49\u5ba2\u6237\u7aef\u548c\u670d\u52a1\u7aef\u4e4b\u95f4\u7684\u5177\u4f53\u4f20\u8f93\u901a\u9053\u548c\u673a\u5236<\/strong>\u3002<\/p>\n<p>Java \u7248\u7684 MCP SDK \u5c06\u8fd9\u4e9b\u6982\u5ff5\u6620\u5c04\u4e3a\u5982\u4e0b\u51e0\u4e2a\u5c42\u6b21\uff1a<\/p>\n<ul>\n<li>Client\/Server \u5c42\uff1a\u901a\u8fc7 <code>McpClient<\/code> \/ <code>McpServer<\/code> \u5b9e\u73b0\u5e76\u7ba1\u7406\u5ba2\u6237\u7aef\/\u670d\u52a1\u7aef\u7684\u5177\u4f53\u64cd\u4f5c<\/li>\n<li>Session \u5c42\uff1a\u901a\u8fc7 <code>McpSession<\/code> \u7ba1\u7406\u901a\u4fe1\u6a21\u5f0f\u548c\u4f1a\u8bdd\u72b6\u6001<\/li>\n<li>Transport \u5c42\uff1a\u901a\u8fc7 <code>McpTransport<\/code> \u5904\u7406\u6d88\u606f\u7684\u5e8f\u5217\u5316\u4e0e\u53cd\u5e8f\u5217\u5316<\/li>\n<\/ul>\n<p>\u5ba2\u6237\u7aef\u4f1a\u8c03\u7528 MCP \u670d\u52a1\u7aef\u66b4\u9732\u7684\u4e00\u5230\u591a\u4e2a\u5de5\u5177\uff08tool\uff09\uff0c\u800c\u5e95\u5c42\u7684\u901a\u4fe1\u5219\u7531\u4f20\u8f93\u5c42\u8d1f\u8d23\u3002<\/p>\n<p>\u5728 MCP \u4e2d\uff0c<strong>Primitive\uff08\u539f\u8bed\uff09<\/strong> \u662f\u6700\u57fa\u7840\u7684\u6784\u5efa\u5355\u5143\uff0c\u7528\u6765\u5b9a\u4e49\u53ef\u7528\u7684\u4e0a\u4e0b\u6587\u4fe1\u606f\u7c7b\u578b\u4ee5\u53ca\u53ef\u6267\u884c\u7684\u64cd\u4f5c\u8303\u56f4\u3002\u670d\u52a1\u7aef\u548c\u5ba2\u6237\u7aef\u90fd\u63d0\u4f9b\u4e86\u4e00\u4e9b\u539f\u8bed\u3002<\/p>\n<p>\u670d\u52a1\u7aef\u4fa7\u7684\u539f\u8bed\u5305\u62ec\u5de5\u5177\uff08tools\uff09\u3001\u8d44\u6e90\uff08resources\uff09\u548c\u63d0\u793a\u6a21\u7248\uff08prompts\uff09\u3002<strong>\u5de5\u5177\u662f AI \u5e94\u7528\u53ef\u4ee5\u8c03\u7528\u7684\u53ef\u6267\u884c\u51fd\u6570<\/strong>\uff0c\u4f8b\u5982\u67e5\u8be2\u6570\u636e\u5e93\u3001\u6587\u4ef6\u64cd\u4f5c\u7b49\u3002<strong>\u8d44\u6e90\u662f\u63d0\u4f9b\u7ed9\u5ba2\u6237\u7aef\u7684\u4e0a\u4e0b\u6587\u6570\u636e\u6e90<\/strong>\uff0c\u4f8b\u5982\u6570\u636e\u5e93\u7ed3\u6784\u3001\u6587\u4ef6\u5185\u5bb9\u7b49\u3002<strong>\u63d0\u793a\u6a21\u7248\u662f\u53ef\u590d\u7528\u7684\u6a21\u7248\uff0c\u7528\u4e8e\u4e0e\u8bed\u8a00\u6a21\u578b\u8fdb\u884c\u4ea4\u4e92<\/strong>\u3002<\/p>\n<p>\u5ba2\u6237\u7aef\u4fa7\u7684\u539f\u8bed\u5219\u5e2e\u52a9 <code>McpServer<\/code> \u7684\u5b9e\u73b0\u8005\u6784\u5efa\u66f4\u4e30\u5bcc\u7684\u4ea4\u4e92\u80fd\u529b\uff0c\u5305\u62ec\u91c7\u6837\uff08sampling\uff09\u3001\u4fe1\u606f\u8865\u5145\uff08elicitation\uff09\u548c\u65e5\u5fd7\uff08logging\uff09\u3002<strong>\u91c7\u6837\u5141\u8bb8\u670d\u52a1\u7aef\u5728\u4e0d\u96c6\u6210\u6a21\u578b SDK \u7684\u60c5\u51b5\u4e0b\uff0c\u5411\u5ba2\u6237\u7aef\u8bf7\u6c42\u8bed\u8a00\u6a21\u578b\u8865\u5168\u7ed3\u679c\u3002<\/strong> <strong>\u4fe1\u606f\u8865\u5145\u8ba9\u670d\u52a1\u7aef\u80fd\u591f\u5411\u7528\u6237\u8bf7\u6c42\u989d\u5916\u4fe1\u606f\u6216\u786e\u8ba4\u64cd\u4f5c\u3002<\/strong> <strong>\u65e5\u5fd7\u5219\u5141\u8bb8\u670d\u52a1\u7aef\u5411\u5ba2\u6237\u7aef\u53d1\u9001\u65e5\u5fd7\u6d88\u606f\uff0c\u7528\u4e8e\u8c03\u8bd5\u548c\u76d1\u63a7\u3002<\/strong><\/p>\n<h2>3. \u73af\u5883\u51c6\u5907<\/h2>\n<p>\u8981\u4f7f\u7528 MCP Java SDK\uff0c\u6211\u4eec\u9700\u8981\u5728\u9879\u76ee\u4e2d\u52a0\u5165 <code>mcp<\/code> \u4f9d\u8d56\uff1a<\/p>\n<pre><code class=\"xml\">&lt;dependency&gt;\n    &lt;groupId&gt;io.modelcontextprotocol.sdk&lt;\/groupId&gt;\n    &lt;artifactId&gt;mcp&lt;\/artifactId&gt;\n    &lt;version&gt;0.15.0&lt;\/version&gt;\n&lt;\/dependency&gt;<\/code><\/pre>\n<h3>3.1 \u5b9a\u4e49\u4e00\u4e2a MCP \u5de5\u5177<\/h3>\n<p>\u6211\u4eec\u5148\u901a\u8fc7 <code>LoggingTool<\/code> \u8fd9\u4e2a\u7c7b\uff0c\u5b9a\u4e49\u4e00\u4e2a\u975e\u5e38\u7b80\u5355\u7684 MCP \u5de5\u5177\uff0c\u7528\u6765\u6253\u5370\u6536\u5230\u7684\u63d0\u793a\u8bcd\uff08prompt\uff09\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u4e00\u4e2a <code>SyncToolSpecification<\/code>\uff1a<\/p>\n<pre><code class=\"java\">public class LoggingTool {\n\n    public static McpServerFeatures.SyncToolSpecification logPromptTool() {\n        McpSchema.JsonSchema inputSchema = new McpSchema.JsonSchema(&quot;object&quot;,\n            Map.of(&quot;prompt&quot;, String.class), List.of(&quot;prompt&quot;), false, null, null);\n\n        return new McpServerFeatures.SyncToolSpecification(\n            new McpSchema.Tool(\n              &quot;logPrompt&quot;, &quot;Log Prompt&quot;,&quot;Logs a provided prompt&quot;, inputSchema, null, null, null),\n                (exchange, args) -&gt; {\n                    String prompt = (String) args.get(&quot;prompt&quot;);\n                    return McpSchema.CallToolResult.builder()\n                      .content(List.of(new McpSchema.TextContent(&quot;Input Prompt: &quot; + prompt)))\n                      .isError(false)\n                      .build();\n                });\n    }\n}<\/code><\/pre>\n<p>\u8fd9\u91cc\u6211\u4eec\u9996\u5148\u5b9a\u4e49\u4e86\u8f93\u5165\u7684 JSON Schema\uff0c\u7528\u6765\u4e3a\u7528\u6237\u8f93\u5165\u5efa\u7acb\u4e00\u4e2a\u6e05\u6670\u7684\u5951\u7ea6\u3002\u63a5\u7740\uff0c\u4f7f\u7528\u8be5\u8f93\u5165 Schema \u6765\u5b9e\u4f8b\u5316\u4e00\u4e2a <code>Tool<\/code>\uff0c\u5728\u5904\u7406\u903b\u8f91\u4e2d\u63d0\u53d6\u51fa <code>prompt<\/code> \u53c2\u6570\uff0c\u5e76\u6700\u7ec8\u8fd4\u56de\u5305\u542b\u8be5 <code>prompt<\/code> \u7684 <code>TextContent<\/code> \u7ed3\u679c\u3002<\/p>\n<h2>4. MCP \u5ba2\u6237\u7aef\u4e0e\u670d\u52a1\u7aef\u642d\u5efa<\/h2>\n<p>\u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u9700\u8981\u4e00\u4e2a MCP \u670d\u52a1\u7aef\u6765\u66b4\u9732\u81ea\u5b9a\u4e49\u5de5\u5177\uff0c\u4ee5\u53ca\u4e00\u4e2a\u6216\u591a\u4e2a MCP \u5ba2\u6237\u7aef\uff0c\u7528\u4e8e\u8fde\u63a5\u8be5\u670d\u52a1\u7aef\u5e76\u8c03\u7528\u5176\u4e2d\u7684\u5de5\u5177\u3002<\/p>\n<h3>4.1 MCP \u670d\u52a1\u7aef\u5b9e\u73b0<\/h3>\n<p><code>McpServer<\/code> \u5177\u6709\u4e00\u7ec4\u80fd\u529b\uff08capabilities\uff09\uff0c\u7528\u6765\u544a\u77e5\u5ba2\u6237\u7aef\u5f53\u524d\u670d\u52a1\u5668\u652f\u6301\u54ea\u4e9b\u7c7b\u522b\u7684\u534f\u8bae\u64cd\u4f5c\uff0c\u4f8b\u5982\u65e5\u5fd7\u8bb0\u5f55\u3001\u63d0\u793a\u8bcd\u8865\u5168\u3001\u8d44\u6e90\u8bbf\u95ee\u7b49\u3002\u6b64\u5916\uff0c\u5de5\u5177\uff08tools\uff09\u5219\u63d0\u4f9b\u7ed9\u5ba2\u6237\u7aef\u53ef\u8c03\u7528\u7684\u5177\u4f53\u51fd\u6570\u3002<\/p>\n<p>\u5148\u6765\u770b\u4e00\u4e2a <code>McpServer<\/code> \u7684\u5b9e\u73b0\uff1a<\/p>\n<pre><code class=\"java\">public class McpServerApp {\n\n    public static McpSyncServer createServer() {\n        JacksonMcpJsonMapper jsonMapper = new JacksonMcpJsonMapper(new ObjectMapper());\n        StdioServerTransportProvider transportProvider = new StdioServerTransportProvider(\n            jsonMapper);\n\n        return McpServer.sync(transportProvider)\n          .serverInfo(&quot;baeldung-demo-server&quot;, &quot;0.0.1&quot;)\n          .capabilities(McpSchema.ServerCapabilities.builder()\n            .tools(true)\n            .logging()\n            .build())\n          .tools(LoggingTool.logPromptTool())\n          .build();\n    }\n\n    public static void main(String[] args) {\n        createServer();\n    }\n}<\/code><\/pre>\n<p>\u4e0a\u9762\u4ee3\u7801\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540c\u6b65\u7684 <code>McpServer<\/code>\uff0c\u901a\u8fc7\u6807\u51c6\u8f93\u5165\/\u8f93\u51fa\u6d41\u5e76\u4f7f\u7528 JSON \u6d88\u606f\u683c\u5f0f\u8fdb\u884c\u901a\u4fe1\u3002\u968f\u540e\u6211\u4eec\u58f0\u660e\u4e86\u670d\u52a1\u5668\u7684\u80fd\u529b\uff1a\u5f00\u542f\u5de5\u5177\u4ee5\u53ca\u65e5\u5fd7\u529f\u80fd\uff08\u57fa\u4e8e SLF4J \u65e5\u5fd7\u6846\u67b6\uff09\uff0c\u6700\u540e\u628a\u81ea\u5b9a\u4e49\u7684 <code>logPromptTool<\/code> \u6ce8\u518c\u5230\u670d\u52a1\u5668\u4e0a\u3002<\/p>\n<h3>4.3 MCP \u5ba2\u6237\u7aef\u5b9e\u73b0<\/h3>\n<p>\u4e0b\u9762\u518d\u5b9a\u4e49\u4e00\u4e2a\u7b80\u5355\u7684 <code>McpClient<\/code>\uff0c\u7528\u4e8e\u8fde\u63a5\u5230\u670d\u52a1\u7aef\uff1a<\/p>\n<pre><code class=\"java\">public class McpClientApp {\n\n    public static McpSyncClient getClient() {\n        ServerParameters params = ServerParameters\n          .builder(&quot;npx&quot;)\n          .args(&quot;-y&quot;, &quot;@modelcontextprotocol\/server-everything&quot;)\n          .build();\n\n        JacksonMcpJsonMapper jsonMapper = new JacksonMcpJsonMapper(new ObjectMapper());\n        McpClientTransport transport = new StdioClientTransport(params, jsonMapper);\n\n        return io.modelcontextprotocol.client.McpClient.sync(transport)\n         .build();\n\n    }\n\n    public static void main(String[] args) {\n        McpSyncClient client = getClient();\n        client.initialize();\n    }\n}<\/code><\/pre>\n<p>\u8fd9\u91cc\u6211\u4eec\u4f7f\u7528 MCP \u63d0\u4f9b\u7684\u793a\u4f8b\u670d\u52a1\u7aef\uff0c\u5e76\u901a\u8fc7 <code>ServerParameters<\/code> \u8fdb\u884c\u914d\u7f6e\u3002\u5ba2\u6237\u7aef\u540c\u6837\u901a\u8fc7\u6807\u51c6\u8f93\u5165\/\u8f93\u51fa\u6d41\u4ee5\u53ca JSON \u6d88\u606f\u683c\u5f0f\u4e0e\u670d\u52a1\u7aef\u8fdb\u884c\u540c\u6b65\u901a\u4fe1\u3002<\/p>\n<h2>5. \u6d4b\u8bd5<\/h2>\n<p>\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u5177\u5907\u4e86\u6d4b\u8bd5 MCP \u4ea4\u4e92\u548c\u6838\u5fc3\u6982\u5ff5\u6240\u9700\u7684\u5168\u90e8\u7ec4\u4ef6\u3002<\/p>\n<h3>5.1 \u6d4b\u8bd5 MCP \u5de5\u5177\u4e0e\u5ba2\u6237\u7aef\u5b9e\u73b0<\/h3>\n<p>\u6211\u4eec\u5148\u4ece\u6d4b\u8bd5 <code>LoggingTool<\/code> \u5f00\u59cb\uff0c\u9a8c\u8bc1\u5176\u8f93\u51fa\u662f\u5426\u6b63\u786e\uff1a<\/p>\n<pre><code class=\"java\">@Test\nvoid whenLogPromptToolCalled_thenReturnsResult() {\n    McpSchema.CallToolRequest request = new McpSchema.CallToolRequest(&quot;&quot;,\n        Map.of(&quot;prompt&quot;, &quot;Unit test message&quot;));\n\n    McpServerFeatures.SyncToolSpecification toolSpec = LoggingTool.logPromptTool();\n    McpSchema.CallToolResult result \n        = toolSpec.callHandler().apply(null, request);\n    assertNotNull(result);\n    assertFalse(result.isError());\n    assertEquals(\n        &quot;Input Prompt: Unit test message&quot;,((McpSchema.TextContent) (result.content()\n        .getFirst()))\n        .text());\n}<\/code><\/pre>\n<p>\u5728\u8fd9\u4e2a\u6d4b\u8bd5\u4e2d\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u5e26\u6709 <code>prompt<\/code> \u7684 <code>CallToolRequest<\/code>\uff0c\u5e76\u5c06\u5176\u4f20\u9012\u7ed9 <code>LoggingTool<\/code> \u7684 <code>SyncToolSpecification<\/code>\u3002\u968f\u540e\uff0c\u6211\u4eec\u65ad\u8a00\u8fd4\u56de\u7ed3\u679c\u975e\u7a7a\u3001\u65e0\u9519\u8bef\uff0c\u5e76\u4e14\u8fd4\u56de\u7684\u6587\u672c\u5185\u5bb9\u4e0e\u9884\u671f\u76f8\u540c\u3002<\/p>\n<p>\u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u518d\u901a\u8fc7 MCP \u63d0\u4f9b\u7684\u793a\u4f8b\u670d\u52a1\u7aef\u6765\u6d4b\u8bd5 <code>McpClient<\/code>\uff1a<\/p>\n<pre><code class=\"java\">@Test\nvoid whenCalledViaClient_thenReturnsLoggedResult() {\n    McpSchema.CallToolRequest request = new McpSchema.CallToolRequest(\n        &quot;echo&quot;, Map.of(&quot;message&quot;, &quot;Client-server test message&quot;));\n    McpSchema.CallToolResult result = client.callTool(request);\n\n    assertNotNull(result);\n    assertNull(result.isError());\n    assertEquals(&quot;Echo: Client-server test message&quot;,\n        ((McpSchema.TextContent) (result.content()\n        .getFirst())).text());\n}<\/code><\/pre>\n<p>MCP \u793a\u4f8b\u670d\u52a1\u7aef\u66b4\u9732\u4e86\u4e00\u4e2a\u540d\u4e3a <code>echo<\/code> \u7684\u5de5\u5177\uff0c\u5b83\u4f1a\u628a\u8f93\u5165\u6d88\u606f\u539f\u6837\u8fd4\u56de\uff0c\u8fd9\u4e0e\u6211\u4eec\u4e4b\u524d\u5b9e\u73b0\u7684 <code>LoggingTool<\/code> \u7684\u884c\u4e3a\u7c7b\u4f3c\u3002<\/p>\n<h3>5.2 \u6d4b\u8bd5\u672c\u5730\u670d\u52a1\u7aef<\/h3>\n<p>\u6700\u540e\uff0c\u6211\u4eec\u6765\u6d4b\u8bd5\u81ea\u5df1\u7f16\u5199\u7684\u672c\u5730\u670d\u52a1\u7aef\u3002\u4e3a\u6b64\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u5355\u72ec\u7684 <code>McpClient<\/code>\uff0c\u5e76\u4f7f\u7528\u6307\u5411\u672c\u5730 JAR \u7684\u4e0d\u540c\u670d\u52a1\u7aef\u53c2\u6570\uff1a<\/p>\n<pre><code class=\"java\">public class McpClientApp2 {\n\n    private static final Logger log = LoggerFactory.getLogger(McpClientApp2.class);\n\n    public static void main(String[] args) {\n        String jarPath = new java.io.File(&quot;java-mcp\/target\/java-mcp-1.0.0-SNAPSHOT.jar&quot;)\n                             .getAbsolutePath();\n        ServerParameters params = ServerParameters.builder(&quot;java&quot;)\n            .args(&quot;-jar&quot;, jarPath)\n            .build();\n\n        JacksonMcpJsonMapper jsonMapper = new JacksonMcpJsonMapper(new ObjectMapper());\n        McpClientTransport transport = new StdioClientTransport(params, jsonMapper);\n\n        McpSyncClient client = McpClient.sync(transport)\n            .build();\n\n        client.initialize();\n\n        ListToolsResult tools = client.listTools();\n        McpClientApp2.log.info(&quot;Tools exposed by the server:&quot;);\n        tools\n          .tools()\n          .forEach(tool -&gt; System.out.println(&quot; - &quot; + tool.name()));\n\n        McpClientApp2.log.info(&quot;\/nCalling 'logPrompt' tool...&quot;);\n        CallToolResult result = client.callTool(\n          new CallToolRequest(&quot;logPrompt&quot;, Map.of(&quot;prompt&quot;, &quot;Hello from MCP client!&quot;)));\n        McpClientApp2.log.info(&quot;Result: &quot; + result.content());\n\n        client.closeGracefully();\n    }\n}<\/code><\/pre>\n<p>\u8fd0\u884c\u8be5\u5ba2\u6237\u7aef\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u65e5\u5fd7\u6765\u9a8c\u8bc1\u5b83\u662f\u5426\u6210\u529f\u8fde\u63a5\u5230\u4e86\u672c\u5730 JAR \u4e2d\u5b9a\u4e49\u7684\u670d\u52a1\u7aef\uff1a<\/p>\n<pre><code class=\"text\">14:04:27.879 [boundedElastic-1] INFO  i.m.c.transport.StdioClientTransport - MCP server starting.\n14:04:27.920 [boundedElastic-1] INFO  i.m.c.transport.StdioClientTransport - MCP server started\n14:04:28.517 [pool-4-thread-1] INFO  i.m.c.transport.StdioClientTransport - STDERR Message received: 14:04:28.504 [pool-1-thread-1] INFO  i.m.server.McpAsyncServer - Client initialize request - Protocol: 2024-11-05, Capabilities: ClientCapabilities[experimental=null, roots=null, sampling=null, elicitation=null], Info: Implementation[name=Java SDK MCP Client, title=null, version=0.15.0]\n14:04:28.575 [pool-1-thread-1] INFO  i.m.client.LifecycleInitializer - Server response with Protocol: 2024-11-05, Capabilities: ServerCapabilities[completions=null, experimental=null, logging=LoggingCapabilities[], prompts=null, resources=null, tools=ToolCapabilities[listChanged=true]], Info: Implementation[name=baeldung-demo-server, title=null, version=0.0.1] and Instructions null\n14:04:28.626 [main] INFO  mcp.McpClientApp2 - Tools exposed by the server:\n14:04:28.626 [main] INFO  mcp.McpClientApp2 - \nCalling 'logPrompt' tool...\n - logPrompt\n14:04:28.671 [main] INFO  mcp.McpClientApp2 - Result: [TextContent[annotations=null, text=Input Prompt: Hello from MCP client!, meta=null]]\n14:04:28.784 [ForkJoinPool.commonPool-worker-1] WARN  i.m.c.transport.StdioClientTransport - Process terminated with code 143\n\nProcess finished with exit code 0<\/code><\/pre>\n<p>\u4ece\u65e5\u5fd7\u53ef\u4ee5\u770b\u5230\uff0c\u9996\u5148 <code>McpServer<\/code> \u542f\u52a8\u6210\u529f\uff0c\u968f\u540e\u5ba2\u6237\u7aef\u5b8c\u6210\u521d\u59cb\u5316\u5e76\u4e0e\u670d\u52a1\u7aef\u5efa\u7acb\u8fde\u63a5\u3002\u63a5\u7740\u5ba2\u6237\u7aef\u8bf7\u6c42\u5217\u51fa\u670d\u52a1\u7aef\u66b4\u9732\u7684\u5de5\u5177\uff0c\u6700\u540e\u5728\u8c03\u7528 <code>logPrompt<\/code> \u5de5\u5177\u4e4b\u540e\uff0c\u6211\u4eec\u4e5f\u770b\u5230\u4e86\u6765\u81ea\u670d\u52a1\u7aef\u7684\u8fd4\u56de\u7ed3\u679c\u3002<\/p>\n<h2>6. \u603b\u7ed3<\/h2>\n<p>\u5728\u672c\u6587\u4e2d\uff0c\u6211\u4eec\u9996\u5148\u56de\u987e\u4e86 MCP \u53ca\u5176 Java SDK \u7684\u6574\u4f53\u67b6\u6784\uff0c\u91cd\u70b9\u4ecb\u7ecd\u4e86 <code>McpServer<\/code>\u3001<code>McpClient<\/code> \u548c <code>McpHost<\/code> \u4e4b\u95f4\u7684\u5173\u7cfb\uff0c\u4ee5\u53ca\u7531 <code>McpTransport<\/code> \u8d1f\u8d23\u7684\u4f20\u8f93\u5c42\u7ec6\u8282\u3002<\/p>\n<p>\u63a5\u7740\uff0c\u6211\u4eec\u4e86\u89e3\u4e86 MCP \u4e2d\u7684\u5404\u79cd\u539f\u8bed\uff08primitives\uff09\uff0c\u4ee5\u53ca\u5728\u670d\u52a1\u7aef\u548c\u5ba2\u6237\u7aef\u4fa7\u5206\u522b\u53ef\u7528\u7684\u7c7b\u578b\u548c\u80fd\u529b\u3002<\/p>\n<p>\u6700\u540e\uff0c\u6211\u4eec\u5b9e\u73b0\u4e86\u4e00\u4e2a\u7b80\u5355\u7684 MCP \u5de5\u5177\uff0c\u5e76\u901a\u8fc7 MCP \u793a\u4f8b\u670d\u52a1\u7aef\u548c\u672c\u5730\u81ea\u5efa\u670d\u52a1\u7aef\uff0c\u9a8c\u8bc1\u4e86 <code>McpClient<\/code> \u7684\u8fde\u63a5\u4e0e\u8c03\u7528\u6d41\u7a0b\u3002\u501f\u52a9 MCP \u6807\u51c6\u548c Java SDK\uff0c\u4f60\u53ef\u4ee5\u66f4\u65b9\u4fbf\u5730\u628a\u73b0\u6709\u7cfb\u7edf\u80fd\u529b\u4ee5\u7edf\u4e00\u7684\u65b9\u5f0f\u66b4\u9732\u7ed9 AI \u5e94\u7528\uff0c\u4e5f\u80fd\u5728\u4e0d\u540c\u9879\u76ee\u4e4b\u95f4\u590d\u7528\u8fd9\u5957\u96c6\u6210\u6a21\u5f0f\u3002<\/p>\n<p><a href=\"https:\/\/segmentfault.com\/a\/1190000047480708\">https:\/\/segmentfault.com\/a\/1190000047480708<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5f53\u6211\u4eec\u628a\u5404\u79cd\u5185\u90e8\u7cfb\u7edf\u3001\u6570\u636e\u6e90\u3001\u5de5\u5177\u63a5\u5165\u5927\u8bed\u8a00\u6a21\u578b\u65f6\uff0c\u5f80\u5f80\u4f1a\u9047\u5230\u4e00\u4e2a\u5c34\u5c2c\u7684\u95ee\u9898\uff1a\u6bcf\u4e2a\u56e2\u961f\u3001\u6bcf\u5957\u7cfb\u7edf\u90fd\u6709\u81ea\u5df1\u7684\u4e00\u5957 [&hellip;]<\/p>\n","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[4],"tags":[],"class_list":["post-10021125","post","type-post","status-publish","format-standard","hentry","category-share"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021125","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10021125"}],"version-history":[{"count":0,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021125\/revisions"}],"wp:attachment":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10021125"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10021125"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10021125"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}