Java MCP 鉴权设计与实现指南

最新推荐文章于 2025-10-09 15:44:24 发布

原创

最新推荐文章于 2025-10-09 15:44:24 发布 · 530 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#java #solon #ai #mcp #authing

一、MCP 鉴权概述

MCP (Model Context Protocol) 旨在为大语言模型（LLM）与外部数据源、工具和服务提供标准化、安全的集成方式（相当于一种专用的 RPC 协议）。广泛应用于 AI 开发中的工具服务(Tool)、提示语服务(Prompt)和资源服务(Resource)。在实际应用中，确保 MCP 服务的安全性至关重要，因此需要合理的鉴权机制。

根据提供的资料，MCP 鉴权主要涉及以下几个方面：

服务端鉴权设计
客户端鉴权配置
不同通讯通道(stdio/SSE)的鉴权实现
与 Web API 互通的鉴权处理

本案基于 Solon AI MCP 进行鉴权方面的探讨：

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-ai-mcp</artifactId>
    <version>最新版本</version>
</dependency>

可支持 java8, java11, java17, java21, java24 。可支持 solon，springboot，vert.x，jFinal 等框架集成。

二、MCP 服务端鉴权设计

1、基于过滤器的鉴权方案

MCP 服务端可以通过过滤器或路由拦截器实现鉴权，特别是对于 HTTP SSE 通道的服务：

@Component
public class McpFilter implements Filter {
   
   
    @Override
    public void doFilter(Context ctx, FilterChain chain) throws Throwable {
   
   
        //message 端点，不需要鉴权
        if (ctx.pathNew().startsWith("/mcp/") && ctx.pathNew().endsWith("/message") == false) {
   
    
            String authStr = ctx.header("Authorization");
            if (Utils.isEmpty(authStr)) {
   
   
                ctx.status(401);
                return;
            }
            // 业务检测逻辑
            if (!checkAuth(authStr)) {
   
   
                ctx.status(403);
                return;
            }
        }
        
        chain.doFilter(ctx);
    }
    
    private boolean checkAuth(String authStr) {
   
   
        // 实现具体的鉴权逻辑
        return true;
    }
}

2、基于注解的端点级鉴权

对于使用 @McpServerEndpoint 注解的服务端点，可以通过 @Header 注解或者上下文对象(Context) 获取用户身份或鉴权信息：

@McpServerEndpoint(sseEndpoint = "/mcp/sse"

最低0.47元/天解锁文章