快捷導(dǎo)航

Java?MCP?的鑒權(quán)深度解析

更新時(shí)間：2025年08月21日 08:48:21 作者：帶刺的坐椅

文章介紹Java MCP鑒權(quán)的實(shí)現(xiàn)方式,指出客戶端可通過(guò)queryString、header或env傳遞鑒權(quán)信息,服務(wù)器端支持工具單獨(dú)鑒權(quán)、過(guò)濾器集中鑒權(quán)及啟動(dòng)時(shí)鑒權(quán),使用solon-ai-mcp等工具可簡(jiǎn)化流程,整體配置較為便捷,感興趣的朋友跟隨小編一起看看吧

（1）方式1：每個(gè)工具各自鑒權(quán)（適合 stdio，sse，streamable 三種傳輸方式）
（2）方式2：為 http 傳輸?shù)乃泄ぞ呒需b權(quán)（適合 sse，streamable http類的傳輸方式）
（3）方式3：程序啟動(dòng)時(shí)鑒權(quán)（適合 stdio 傳輸方式）

聽(tīng)說(shuō) mcp 的鑒權(quán)，是件很麻煩的事情？估計(jì)是沒(méi)選好工具。

MCP (Model Context Protocol) 旨在為大語(yǔ)言模型（LLM）與外部數(shù)據(jù)源、工具和服務(wù)提供標(biāo)準(zhǔn)化、安全的集成方式（相當(dāng)于一種專用的 RPC 協(xié)議）。廣泛應(yīng)用于 AI 開(kāi)發(fā)中的工具服務(wù)(Tool)、提示語(yǔ)服務(wù)(Prompt)和資源服務(wù)(Resource)。在實(shí)際應(yīng)用中，確保 MCP 服務(wù)的安全性至關(guān)重要，因此需要合理的鑒權(quán)機(jī)制。

一、MCP Client 側(cè)（負(fù)責(zé)傳遞，比較簡(jiǎn)單）

在客戶端，一般是使用 queryString 或者 header 或者 env（stdio 方式用）傳遞鑒權(quán)信息，比如變量：token（名字隨便取）

（1）常見(jiàn)的 mcpServers json 配置方式

不同服務(wù)平臺(tái)，mcpServers json 的配置格式可能會(huì)略有不同。具體需要按服務(wù)平臺(tái)要求配置。

使用 queryString 傳遞（http 類傳輸方式）

{
    "mcpServers": {
        "demo": {
            "type":"sse"
            "url": "https://localhost:8080/mcp?token=xxxx"
        }
    }
}

使用 header 傳遞（http 類傳輸方式）

{
    "mcpServers": {
        "demo": {
            "type":"streamable",
            "url": "https://localhost:8080/mcp",
            "headers": {"token":"xxx"}
        }
    }
}

使用 env 傳遞（stdio 傳輸方式）

{
    "mcpServers": {
        "demo": {
            "type":"stdio",
            "command":"java",
            "args": ["-jar", "/data/demo/target/demo-mcp-stdio.jar"]
            "env": {"token": "xxx"}
        }
    }
}

（2）使用 solon-ai-mcp 作為客戶端

solon-ai-mcp 是比較簡(jiǎn)潔的 mcp java client 框架。它的體驗(yàn)與 mcpServers json 配置相差不大。

使用 queryString 傳遞（http 類傳輸方式）

import org.noear.solon.ai.mcp.client.McpClientProvider;
McpClientProvider mcpClient =  McpClientProvider.builder()
                .channel(McpChannel.SSE) //表示使用 sse 傳輸方式
                .apiUrl("https://localhost:8080/mcp?token=xxxx")
                .build();
//mcpClient.getTools();

使用 header 傳遞（http 類傳輸方式）

import org.noear.solon.ai.mcp.client.McpClientProvider;
McpClientProvider mcpClient =  McpClientProvider.builder()
                .channel(McpChannel.STREAMABLE) //表示使用 streamable 傳輸方式
                .apiUrl("https://localhost:8080/mcp")
                .headerSet("token", "xxxx")
                .build(); 
//mcpClient.getTools();

使用 env 傳遞（stdio 傳輸方式）

import org.noear.solon.ai.mcp.client.McpClientProvider;
McpClientProvider mcpClient = McpClientProvider.builder()
                .channel(McpChannel.STDIO) //表示使用 stdio 傳輸方式
                .serverParameters(McpServerParameters.builder("java")
                        .args("-jar", "/data/demo/target/demo-mcp-stdio.jar")
                        .addEnvVar("token","xxx")
                        .build())
                .build();
//mcpClient.getTools();

與 chatModel 結(jié)合使用示例：

import org.noear.solon.ai.chat.ChatModel;
import org.noear.solon.ai.chat.ChatResponse;
ChatModel chatModel = ChatModel.of(apiUrl).provider(provider).model(model)
                .defaultToolsAdd(mcpClient) //重點(diǎn)是這一行
                .build();
ChatResponse resp = chatModel
        .prompt("今天杭州的天氣情況？")
        .call();

二、MCP Server 側(cè)（也好簡(jiǎn)單的）

（1）方式1：每個(gè)工具各自鑒權(quán)（適合 `stdio`，`sse`，`streamable` 三種傳輸方式）

在 solon-ai-mcp 里，可以使用 @Header 注解，獲取 mcp 連接的元信息（比如 queryString、header、env）

import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.McpChannel;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Header;
import org.noear.solon.annotation.Param;
@McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
public class McpServerTool {
    @ToolMapping(description = "你好世界")
    public String hello(@Param(name="name", description = "名字") String name, @Header("token") String token) {
        if(token == null) {
            throw new IllegalArgumentException("你沒(méi)有權(quán)限哦!");
        }
        return "你好，" + name;
    }
}

（2）方式2：為 http 傳輸?shù)乃泄ぞ呒需b權(quán)（適合 `sse`，`streamable` http類的傳輸方式）

solon-ai-mcp 也可以通過(guò)過(guò)濾器（Filter），實(shí)現(xiàn)單點(diǎn)鑒權(quán)。

@Managed
public class McpServerTool implements Filter {
    @Override
    public void doFilter(Context ctx, FilterChain chain) throws Throwable {
        if (ctx.pathNew().equals("/mcp")) {
            String token = ctx.header("token"); //支持從 header 取
            if (token == null) {
                token = ctx.param("token"); //支持從 queryString 取
            }
            if (token == null) {
                ctx.status(401, "你沒(méi)有權(quán)限哦!");
                return;
            }
        }
        chain.doFilter(ctx);
    }
}

（3）方式3：程序啟動(dòng)時(shí)鑒權(quán)（適合 `stdio` 傳輸方式）

@SolonMain
public class McpApp {
    public static void main(String[] args) {
        String token = System.getenv("token");
        if (Utils.isEmpty(token)) {
            throw new RuntimeException("你沒(méi)有權(quán)限哦");
        }
        Solon.start(McpApp.class, args);
    }
}

到此這篇關(guān)于Java MCP 的鑒權(quán)？好簡(jiǎn)單的啦的文章就介紹到這了,更多相關(guān)Java MCP 鑒權(quán)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: