Spring AIにおけるモデルコンテキストプロトコルのセキュリティおよび認可サポート。

⚠️ mcp-securityのバージョン0.1.xはSpring AIの2.0.xブランチのみを動作させます。Spring AI 1.1.xの場合はバージョン0.0.6を使用してください。

目次

• 概要
• MCPサーバーセキュリティ
• MCPクライアントセキュリティ
• 認可サーバー
• サンプル
• 統合(カーソル、Claude Desktopなど)
• ライセンス

概要

このリポジトリは以下の通りです。 認可サポート Spring AIとモデルコンテキストプロトコル(MCP)との統合。MCPクライアント、MCPサーバー、Springの両方をカバーします 認可サーバー。

このプロジェクトにより、開発者は以下のことを可能にしています:

• OAuth 2.0認証を備えたセキュアMCPサーバー
• OAuth 2.0認証フローでMCPクライアントを設定する
• MCPワークフロー専用に設計された認可サーバーの設置
• MCPツールおよびリソースに対して細かいアクセス制御を実装する

MCPサーバーのセキュリティ

OAuth 2.0リソースサーバー機能を提供します Spring AIのMCPサーバー用です。 また、APIキーベースのサーバーに対する基本的なサポートも提供しています。 OAuth2およびAPIキー認証は、Spring WebMVCベースのサーバーのみと互換性があります。 Origin ValidationはSpring WebFluxもサポートしています。

MCP Security

Security and Authorization support for Model Context Protocol in Spring AI.

⚠️ Versions 0.1.x of mcp-security only work Spring AI’s 2.0.x branch. For Spring AI 1.1.x, use version 0.0.6.

Table of Contents

• Overview
• MCP Server Security
• MCP Client Security
• Authorization Server
• Samples
• Integrations (Cursor, Claude Desktop, …)
• License

Overview

This repository provides Authorization support for Spring AI integrations with the Model Context Protocol (MCP). It covers both MCP Clients, MCP Servers, and Spring Authorization Server.

The project enables developers to:

• Secure MCP servers with OAuth 2.0 authentication
• Configure MCP clients with OAuth 2.0 authorization flows
• Set up authorization servers specifically designed for MCP workflows
• Implement fine-grained access control for MCP tools and resources

MCP Server Security

Provides OAuth 2.0 resource server capabilities for Spring AI’s MCP servers. It also provides basic support for API-key based servers. OAuth2 and API-key authentication are compatible with Spring WebMVC-based servers only. Origin validation additionally supports Spring WebFlux.

Quick start with mcp-server-security-spring-boot (recommended)

The easiest way to add OAuth2 security to your MCP server is with the Boot auto-configuration module. It provides a default SecurityFilterChain that secures all endpoints, with no additional configuration required beyond setting the issuer URI.

Maven

    
        org.springaicommunity
        mcp-server-security-spring-boot
        0.1.14
    

Gradle

implementation("org.springaicommunity:mcp-server-security-spring-boot:0.1.14")

Then configure your application.properties:

spring.ai.mcp.server.name=my-cool-mcp-server
spring.ai.mcp.server.protocol=STREAMABLE

# The issuer URI of the authorization server
spring.security.oauth2.resourceserver.jwt.issuer-uri=http://localhost:9000

That’s it. When spring.security.oauth2.resourceserver.jwt.issuer-uri is set, the auto-configuration creates a SecurityFilterChain that secures all endpoints using the McpServerOAuth2Configurer.

For a complete working example, see the