MCP Oauth2 Aws Cognito

该项目演示了如何使用OAuth 2.1授权流程和AWS Cognito保护MCP服务器，包含资源服务器、授权服务器、动态客户端注册等核心功能实现。

安全开发者工具 #MCP授权 #OAuth2.1 #AWS认证 #动态注册 .JavaScript

评分 : 2.5分

下载量 : 8.9K

更新时间 : 2025-04-28

打开站点

什么是MCP OAuth2.1服务器?

这是一个基于Model Context Protocol(MCP)的安全服务器，使用最新的OAuth 2.1标准与AWS Cognito身份验证服务集成，为您的应用程序提供企业级的安全保护。

如何使用这个服务?

您可以通过简单的三步使用这个服务：1) 部署AWS资源 2) 配置客户端 3) 开始安全认证流程。服务会自动处理复杂的OAuth流程。

适用场景

非常适合需要安全认证的企业应用、需要与多种身份提供商集成的SaaS平台，以及需要符合最新安全标准的金融/医疗应用。

主要功能

OAuth 2.1支持

实现最新的OAuth 2.1标准，包括PKCE增强安全性

动态客户端注册

客户端可以自动注册，无需预先配置

AWS Cognito集成

与AWS企业级身份验证服务无缝集成

自动发现

客户端自动发现授权服务器和端点

优势

符合最新的MCP授权规范和OAuth 2.1标准

支持动态客户端注册，简化部署流程

与AWS Cognito集成，提供企业级安全性

自动发现功能减少配置工作量

局限性

需要AWS账户和基本云服务知识

动态注册在生产环境中需要额外安全措施

Cognito原生不支持某些OAuth 2.1功能

如何使用

准备环境

确保您已安装Node.js并拥有AWS测试账户

安装依赖

安装所有必要的依赖包

部署AWS资源

一键部署所有必要的AWS资源

启动应用

同时启动客户端和服务器

使用案例

新用户注册流程

演示如何通过Cognito托管UI注册新用户并访问受保护资源

动态客户端注册

展示客户端如何自动发现并注册到新的MCP服务器

常见问题

我需要付费使用这个服务吗?

这个方案适合生产环境吗?

支持哪些OAuth流程?

🚀 MCP + OAuth2.1 + 亚马逊Cognito 实现的模型上下文协议身份验证示例项目

这是一个基于模型上下文协议（MCP）与OAuth2.1结合，使用亚马逊Cognito作为授权服务器的示例项目，展示了如何在实际应用中实现基于模型上下文协议的安全身份验证和授权流程。

🚀 快速开始

先决条件

环境要求：
- 已安装Node.js。
- 拥有亚马逊AWS测试账号，并具备以下资源权限：
  - Cognito用户池（用于OAuth2.1授权服务器）。
  - API Gateway、Lambda、DynamoDB（用于动态客户端注册功能）。
  - CloudFormation（用于部署资源栈）。
基本知识：
- 熟悉模型上下文协议（MCP）的基本概念。
- 掌握OAuth2.1协议的工作原理。

部署步骤

克隆项目仓库：

git clone https://github.com/empires-security/mcp-oauth2-aws-cognito.git
cd mcp-oauth2-aws-cognito

安装依赖项：
```
npm run install:all
```
部署亚马逊云资源：
```
npm run deploy
```
更新生成的.env文件：
- 检查并更新src/client/.env、src/auto-client/.env、src/mcp-server/.env中的配置。
- 对比.env.example，确保所有环境变量正确设置。

✨ 主要特性

动态发现机制：客户端能够自动识别并连接到最近的MCP服务器。
OAuth2.1集成：支持与亚马逊Cognito的身份池无缝对接。
角色管理：基于模型上下文协议的角色定义，实现细粒度的访问控制。

📦 安装指南

部署步骤

克隆项目仓库：

git clone https://github.com/empires-security/mcp-oauth2-aws-cognito.git
cd mcp-oauth2-aws-cognito

安装依赖项：
```
npm run install:all
```
部署亚马逊云资源：
```
npm run deploy
```
更新生成的.env文件：
- 检查并更新src/client/.env、src/auto-client/.env、src/mcp-server/.env中的配置。
- 对比.env.example，确保所有环境变量正确设置。

💻 使用示例

基础用法

启动服务

启动MCP服务器：
```
cd mcp-server && npm start
```
启动OAuth2.1授权服务器：
```
cd oauth-server && npm start
```
启动手动配置客户端：
```
cd client && npm start
```
启动自动化客户端：
```
cd auto-client && npm start
```

示例命令

部署项目：
```
npm run deploy
```
更新环境变量：
```
cp .env.example .env
```

📚 详细文档

项目架构

总体架构

MCP服务层：
- 提供模型上下文协议的安全验证和授权功能。
- 支持与OAuth2.1授权服务器的集成。
OAuth2.1授权服务器：
- 使用亚马逊Cognito用户池实现身份验证。
- 处理OAuth2.1令牌颁发、刷新等流程。
客户端层：
- 包括自动化客户端和手动配置客户端两种类型。
- 自动化客户端具备自动发现功能，能够动态连接到MCP服务器。
- 手动配置客户端支持自定义配置，适用于复杂环境。