技术文档摘要

使用OAuth认证的MCP

这是一个提供实现远程MCP服务器OAuth认证的示例代码和演示环境的仓库。

遵循MCP Spec的2025-06-18版本 https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization

本仓库的实现大量参考了以下仓库 https://github.com/modelcontextprotocol/python-sdk/tree/main/examples

本仓库的目的

本仓库旨在通过一系列示例实现，学习并实际体验如何在远程MCP（模型上下文协议）服务器上添加OAuth认证功能。

通过查看从所有组件都在本地实现到各个组件采用托管方式实现的不同配置，加深对相关概念的理解。

文件夹结构

当前，本仓库包含三种不同的实现模式：

cognito-and-ac-gateway/

AWS全托管实现

使用AWS托管服务的配置示例。

组件：

• 授权服务器：Amazon Cognito
• MCP服务器：AgentCore Gateway
• 客户端：本地(client.py)

cognito/

Cognito与本地MCP服务器的混合实现

使用AWS Cognito作为认证基础，MCP服务器在本地运行的配置示例。

组件：

• 授权服务器：Amazon Cognito
• MCP服务器：本地(mcp-server-with-auth.py)
• 客户端：本地(client.py)

local/

完全在本地环境中实现

所有组件都在本地运行，适合学习和开发的示例。

组件：

• 授权服务器：本地(auth_server.py)
• MCP服务器：本地(mcp-server-with-auth.py)
• 客户端：本地(client.py)