MCP 协议解析
MCP（Model Context Protocol）是 Anthropic 提出的开放协议，让 AI 安全、标准化地连接外部数据源和工具。Java 如何搭建 MCP Server？
一、MCP 是什么
- 1.1 问题——每个 AI 应用都要单独对接数据源
- 1.2 MCP 的解决方案——标准化的 Client-Server 协议
- 1.3 类比——MCP 之于 AI，就像 USB 之于外设
二、MCP 协议架构
- 2.1 MCP Host——AI 应用（Claude Desktop / IDE）
- 2.2 MCP Client——协议客户端，与 Server 通信
- 2.3 MCP Server——提供工具和资源的服务端
- 2.4 传输层——stdio / SSE
三、MCP 的核心能力
- 3.1 Resources——暴露数据（文件、数据库记录）
- 3.2 Tools——暴露可执行的操作
- 3.3 Prompts——预定义的提示词模板
- 3.4 Sampling——Server 请求 LLM 生成
四、用 Java 搭建 MCP Server
- 4.1 Spring AI MCP 支持
- 4.2 定义 Resource——
@Resource注解 - 4.3 定义 Tool——
@Tool注解 - 4.4 启动 MCP Server
- 4.5 完整代码示例
五、MCP 的安全设计
- 5.1 用户授权——每次操作需要确认
- 5.2 最小权限——只暴露必要的资源
- 5.3 沙箱隔离——限制操作范围
六、总结
- MCP 是 AI 与外部系统的”标准化接口”
- Java 生态正在快速跟上
本博客所有文章除特别声明外，均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 谜思录！
相关推荐
2020-11-28
MongoDB 聚合管道实践
订单统计：按天/按商品/按地区多维分析。用 MySQL 需要复杂的 GROUP BY 和多表 JOIN，MongoDB 聚合管道一行搞定。 一、聚合管道简介 1.1 管道的概念——文档流经多个阶段，逐步处理 1.2 常用阶段——$match / $group / $sort / $project / $lookup 1.3 与传统 SQL 的对应关系 二、$match——过滤 2.1 等价于 WHERE 2.2 尽量放在管道最前面——减少后续处理量 2.3 支持索引 三、$group——分组聚合 3.1 等价于 GROU...
2019-04-13
网关自定义过滤器开发实践
Spring Cloud Gateway 基于 WebFlux 的响应式架构，比 Zuul 1.x 性能更好。本文从路由规则到自定义过滤器，一步步搭建生产可用的网关。 一、网关的核心职责 1.1 路由转发——请求分发到对应的微服务 1.2 统一鉴权——Token 校验、权限控制 1.3 限流——基于 Redis 的令牌桶 1.4 日志/监控——请求日志、调用链 1.5 协议转换——HTTP → gRPC / WebSocket 二、Spring Cloud Gateway 核心概念 2.1 Route——路由，ID + URI + Predicates + Fi...
2019-06-29
服务调用超时与重试配置
一个服务挂了，因为重试风暴，整个系统都被拖垮。超时和重试配置不当，是分布式系统中 80% 雪崩的元凶。 一、超时配置的层次 1.1 连接超时（Connect Timeout）——建立连接的超时 1.2 读取超时（Read Timeout）——等待响应的超时 1.3 请求超时（Request Timeout）——整个请求的总体超时 1.4 链路上各层超时的关系——Nginx → Gateway → RPC → DB 二、超时时间的计算 2.1 基于 P99 响应时间 + 一定 buffer 2.2 上下游超时的关系——下游超时 < 上游超时 2.3 Dubbo 的超时配置——t...
2022-10-15
并发工具类对比与实践
一个接口需要调用 3 个微服务，串行 300ms。用 CompletableFuture 并行调用只需 120ms。 一、场景描述 1.1 商品详情页——需要商品信息、库存、评价、推荐 1.2 串行调用——逐个等待，时间累加 1.3 并行调用的收益——总时间 = max(每个调用的时间) 二、CountDownLatch 2.1 原理——计数器，主线程等待所有子任务完成 2.2 代码示例——3 个线程并行获取数据 2.3 缺点——无法获取返回值、只能使用一次 三、CyclicBarrier 3.1 原理——所有线程到达 barrier 后一起继续 3.2 与 Count...
2015-01-17
Spring 事务失效场景与原因分析
“@Transactional 怎么不生效？” 这个问题被问了无数遍。本文总结 8 个事务失效场景，每个都有代码复现和修正方案。 一、事务不生效的总根源 1.1 Spring 事务是 AOP 代理实现的 1.2 所有失效原因最终都归结为”代理没有生效”或”异常没有触发回滚” 二、场景 1：非 public 方法 2.1 原理——CGLIB 无法代理 private/protected 方法 2.2 错误示例与修正 三、场景 2：自调用问题 3.1 同类中方法 A 调用方法 B，B 的事务失效 3.2 解决方案——AopContext.currentProxy() 或拆分...
2018-12-01
慢 SQL 优化实践
订单列表接口线上响应 3 秒，用户投诉不断。本文还原从发现到优化的全过程。 一、问题发现 1.1 监控告警——接口 RT P99 超 3 秒 1.2 慢查询日志——long_query_time = 1s 1.3 定位到具体 SQL 二、分析阶段 2.1 EXPLAIN 执行计划——type=ALL，全表扫描 2.2 表数据量——订单表 500 万行 2.3 当前的索引情况 三、优化 1：添加索引 3.1 创建 idx_user_status_time(user_id, status, create_time) 3.2 EXPLAIN 对比——type=ref...