<think>嗯，用户的问题是关于在
Spring Boot项目中使用
spring-ai-mcp-client
-spring-boot
-starter依赖来实现一个
MCP协议客户端，同时支持动态配置的外部
MCP Server和内部自定义Tools。我需要先理解用户的具体需求。
首先，用户提到了
MCP协议客户端，需要动态配置外部服务器和内部工具。动态配置可能意味着通过配置文件或环境变量来指定
MCP服务器的地址和其他参数，而不是硬编码在代码中。内部自定义Tools可能是指用户自己开发的一些工具或服务，需要被
MCP客户端调用。
接下来，我需要考虑如何整合
spring-ai的SDK。根据用户提供的引用内容，他们之前已经使用了
spring-boot
-starter
-web和
spring-boot
-starter
-data
-jpa，可能对
Spring Boot的依赖管理比较熟悉。现在需要添加
spring-ai-mcp-client
-spring-boot
-starter依赖，这应该是一个
Spring Boot Starter，简化了配置和集成。
用户需要完整的代码示例，所以应该包括pom.xml的依赖配置、应用配置、客户端实现、工具定义以及控制器示例。可能需要用到@ConfigurationProperties来动态读取外部配置，比如
MCP服务器的URL、认证信息等。同时，内部Tools可能需要通过
Spring的依赖注入来注册到客户端中。
另外，用户希望客户端能同时调用外部服务和内部工具，可能需要设计一个客户端类，能够根据请求的类型路由到不同的服务。比如，使用策略模式或简单的条件判
断来决定调用哪个服务。
在代码结构方面，应该遵循
Spring Boot的最佳实践，比如将配置类放在config包下，控制器放在controller包下，服务类放在service包下。需要确保配置正确加载，依赖注入没有问题。
还需要考虑异常处理，比如当外部服务不可达或配置错误时，客户端应该有相应的处理机制。不过用户可能暂时不需要详细的错误处理，但代码示例中最好包含基本的配置验证。
最后，提供相关问题，帮助用户深入理解相关技术点，比如动态配置的实现原理、如何扩展自定义工具、性能优化等。</think>### 分步实现
MCP协议客户端
#### 1. 添加依赖配置（pom.xml）
```xml
<dependencyManagement>
<dependencies>
<!
-- 添加
Spring AI BOM
-->
<dependency>
<groupId>org.
springframework.
ai</groupId>
<artifactId>
spring-ai-bom</artifactId>
<version>0.8.1</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!
-- MCP客户端核心依赖
-->
<dependency>
<groupId>org.
springframework.
ai</groupId>
<artifactId>
spring-ai-mcp-client
-spring-boot
-starter</artifactId>
</dependency>
<!
-- 动态配置支持
-->
<dependency>
<groupId>org.
springframework.boot</groupId>
<artifactId>
spring-boot
-starter
-actuator</artifactId>
</dependency>
</dependencies>
```
#### 2. 应用配置（application.yml）
```yaml
spring:
ai:
mcp:
client:
endpoint: ${
MCP_
SERVER_URL:http://default
-mcp-server:8080} # 动态配置支持
connection
-timeout: 5000
read
-timeout: 10000
tools:
enabled: true # 启用内部工具调用
```
#### 3. 客户端配置类（
McpClientConfig.java）
```java
@Configuration
@EnableConfigurationProperties(
McpClientProperties.class)
public class
McpClientConfig {
@Bean
public
McpClient
mcpClient(RestTemplateBuilder builder,
McpClientProperties properties,
@Autowired(required = false) List<
McpTool> tools) {
return new
McpClientBuilder()
.restTemplate(builder
.setConnectTimeout(Duration.ofMillis(properties.getConnectionTimeout()))
.setReadTimeout(Duration.ofMillis(properties.getReadTimeout()))
.build())
.baseUrl(properties.getEndpoint())
.withTools(tools != null ? tools : Collections.emptyList())
.build();
}
}
```
#### 4. 自定义工具实现（示例：DataQueryTool.java）
```java
@Component
public class DataQueryTool implements
McpTool {
private static final String TOOL_NAME = "internal_data_query";
@Override
public String getName() {
return TOOL_NAME;
}
@Override
public Object execute(Map<String, Object> parameters) {
// 实现自定义业务逻辑
return queryDatabase(parameters.get("query").toString());
}
private List<Map<String, Object>> queryDatabase(String sql) {
// 实际数据库操作
return Collections.emptyList();
}
}
```
#### 5. 控制器实现（
McpController.java）
```java
@RestController
@RequestMapping("/
mcp")
public class
McpController {
private final
McpClient
mcpClient;
public
McpController(
McpClient
mcpClient) {
this.
mcpClient =
mcpClient;
}
@PostMapping("/execute")
public ResponseEntity<?> executeRequest(@RequestBody
McpRequest request) {
try {
Object response =
mcpClient.execute(request);
return ResponseEntity.ok(response);
} catch (
McpClientException e) {
return ResponseEntity.status(e.getStatusCode()).body(e.getErrorDet
ails());
}
}
}
```
#### 6. 动态配置刷新（通过Actuator）
```bash
# 动态更新
MCP服务端点
curl
-X POST http://localhost:8080/actuator/refresh
-d '{"
spring.
ai.
mcp.client.endpoint":"http://new
-server:8080"}'
```
### 关键特性说明
1. **动态配置支持**：通过`@RefreshScope`和
Spring Cloud Config实现
运行时配置更新[^1]
2. **工具自动注册**：所有实现`
McpTool`接口的Bean会自动注入客户端
3. **双模式调用**：
```java
// 调用外部
MCP服务
mcpClient.executeRemote(request);
// 调用内部工具
mcpClient.executeLocalTool("internal_data_query", params);
```
最低0.47元/天 解锁文章
扫一扫
638
到【灌水乐园】发言
