MCP Oauth2 Aws Cognito

🚀 MCP + OAuth2.1 + 亞馬遜Cognito 實現的模型上下文協議身份驗證示例項目

這是一個基於模型上下文協議（MCP）與OAuth2.1結合，使用亞馬遜Cognito作為授權服務器的示例項目，展示瞭如何在實際應用中實現基於模型上下文協議的安全身份驗證和授權流程。

🚀 快速開始

先決條件

1. 環境要求：
   • 已安裝Node.js。
   • 擁有亞馬遜AWS測試賬號，並具備以下資源權限：
     • Cognito用戶池（用於OAuth2.1授權服務器）。
     • API Gateway、Lambda、DynamoDB（用於動態客戶端註冊功能）。
     • CloudFormation（用於部署資源棧）。
2. 基本知識：
   • 熟悉模型上下文協議（MCP）的基本概念。
   • 掌握OAuth2.1協議的工作原理。

部署步驟

1. 克隆項目倉庫：

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

2. 安裝依賴項：

   npm run install:all
   

3. 部署亞馬遜雲資源：

   npm run deploy
   

4. 更新生成的.env文件：
   • 檢查並更新src/client/.env、src/auto-client/.env、src/mcp-server/.env中的配置。
   • 對比.env.example，確保所有環境變量正確設置。

✨ 主要特性

• 動態發現機制：客戶端能夠自動識別並連接到最近的MCP服務器。
• OAuth2.1集成：支持與亞馬遜Cognito的身份池無縫對接。
• 角色管理：基於模型上下文協議的角色定義，實現細粒度的訪問控制。

📦 安裝指南

部署步驟

1. 克隆項目倉庫：

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

2. 安裝依賴項：

   npm run install:all
   

3. 部署亞馬遜雲資源：

   npm run deploy
   

4. 更新生成的.env文件：
   • 檢查並更新src/client/.env、src/auto-client/.env、src/mcp-server/.env中的配置。
   • 對比.env.example，確保所有環境變量正確設置。

💻 使用示例

基礎用法

啟動服務

1. 啟動MCP服務器：

   cd mcp-server && npm start
   

2. 啟動OAuth2.1授權服務器：

   cd oauth-server && npm start
   

3. 啟動手動配置客戶端：

   cd client && npm start
   

4. 啟動自動化客戶端：

   cd auto-client && npm start
   

示例命令

1. 部署項目：

   npm run deploy
   

2. 更新環境變量：

   cp .env.example .env
   

📚 詳細文檔

項目架構

總體架構

• MCP服務層：
  • 提供模型上下文協議的安全驗證和授權功能。
  • 支持與OAuth2.1授權服務器的集成。
• OAuth2.1授權服務器：
  • 使用亞馬遜Cognito用戶池實現身份驗證。
  • 處理OAuth2.1令牌頒發、刷新等流程。
• 客戶端層：
  • 包括自動化客戶端和手動配置客戶端兩種類型。
  • 自動化客戶端具備自動發現功能，能夠動態連接到MCP服務器。
  • 手動配置客戶端支持自定義配置，適用於複雜環境。

關鍵組件

1. 模型上下文協議服務（MCP-Server）：

• 提供基於角色的訪問控制功能。
• 支持與OAuth2.1授權服務器的安全集成。

2. OAuth2.1模塊：

• 實現標準的OAuth2.1協議流程。
• 與亞馬遜Cognito用戶池對接，提供身份驗證服務。

3. 自動發現機制：

• 客戶端能夠動態識別並連接到最近的MCP服務器。
• 支持負載均衡和故障轉移功能。

項目結構

核心目錄

1. mcp-server：

• 實現模型上下文協議的安全服務。
• 提供基於角色的訪問控制功能。

2. oauth-server：

• 使用亞馬遜Cognito用戶池實現OAuth2.1授權服務器。
• 支持密碼授予、客戶_credentials等標準流程。

3. client：

• 提供手動配置的客戶端實現。
• 支持自定義MCP服務器和OAuth2.1授權服務器的配置。

4. auto-client：

• 自動化客戶端模塊，具備自動發現功能。
• 集成OAuth2.1模塊，支持動態授權流程。

🔧 技術細節

項目介紹

• 技術選型：
  • 模型上下文協議（MCP）：用於定義和管理模型之間的交互規則。
  • OAuth2.1：實現安全的身份驗證和授權機制。
  • 亞馬遜Cognito：作為用戶身份池，提供用戶認證功能。

核心組件

1. MCP服務器：

• 實現模型上下文協議的安全服務。
• 提供基於角色的訪問控制（RBAC）功能。
• 支持與OAuth2.1授權服務器的集成。

2. OAuth2.1授權服務器：

• 使用亞馬遜Cognito作為用戶池，實現身份驗證和授權功能。
• 支持標準的OAuth2.1協議流程，包括密碼授予、客戶_credentials等。

3. 自動化客戶端：

• 具備自動發現功能，能夠動態識別並連接到最近的MCP服務器。
• 集成OAuth2.1模塊，支持自動授權流程。

4. 手動配置客戶端：

• 提供手動配置選項，允許用戶自定義MCP服務器和OAuth2.1授權服務器的參數。
• 支持高級功能，如多因素認證（MFA）和證書綁定。

📄 許可證

本項目遵循MIT License協議。

👨‍💻 項目作者

開發團隊

• 帝國安全實驗室（Empire Security Lab）：專注於模型上下文協議和OAuth2.1協議的研究與實現。

聯繫信息

• 郵箱：contact@empiresecuritylab.com
• 官網：https://www.empiresecuritylab.com