Sample Oauth Lambda MCP

MCP安全风控

提供方 k-ibaraki · 包名 cdk

安全风控 stdio · 本地进程 OAuth 授权 社区 / 第三方
查看接入方式

一个集成FastMCP框架、AWS Cognito OAuth和Passkey认证的服务器端解决方案,适用于需要安全认证的MCP协议应用。

一句话选型结论

按资料字段整理

Sample Oauth Lambda MCP 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

认证服务TypeScript本地部署OAuth集成密码认证AWSCognito服务器框架

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx cdk bootstrap

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Sample Oauth Lambda MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方k-ibaraki上游标注的维护方 k-ibaraki
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时cdk · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.7 KB
来自项目仓库与上游目录的原文,未做删改

FastMCP + Cognito OAuth + 密钥认证

这是一个在AWS Lambda上运行FastMCP,并集成了Cognito托管登录和密码密钥认证的MCP服务器的示例项目。

概要

此项目是一个集以下技术于一体的端到端的示例:

  • FastMCP用Python编写的高速MCP服务器框架
  • FastMCP OIDC代理自动整合符合OIDC标准的OAuth 2.0认证的代理
  • AWS Cognito(亚马逊网络服务身份验证与用户管理服务)全托管认证服务
  • 管理登录托管于Cognito的认证用户界面(支持密码密钥)
  • AWS Lambda无服务器执行环境(Python 3.12)
  • 曼古姆用于在Lambda上运行ASGI应用程序的适配器
  • AWS CDK(Amazon Web Services Cloud Development Kit,亚马逊网络服务云开发工具包)通过基础设施即代码自动部署资源

项目构成```

.
├── sample-oauth-lambda-mcp.ts # CDKアプリケーションエントリーポイント
├── stack/
│ ├── main-stack.ts # MainStack(Cognito、Lambda、Function URL)
│ └── update-stack.ts # UpdateStack(Custom Resourceで設定更新)
├── lambda/
│ ├── main.py # FastMCPサーバー実装
│ ├── pyproject.toml # Python依存関係
│ └── .env.example # 環境変数テンプレート
├── package.json # Node.js依存関係
└── cdk.json # CDK設定


### CDK堆栈配置

该项目由两个堆栈组成:

- Cognito User Pool(支持密码密钥认证)
- Cognito 用户池域名(托管登录)
- 用户池客户端(OAuth设置)
- Lambda 函数(FastMCP 服务器)
- 函数URL(HTTPS终端节点)

1. **更新堆栈** (`SampleOauthLambdaMcpUpdateStack`)

- 自定义资源:获取客户端密钥
- 自定义资源:更新回调URL
- 自定义资源:更新Lambda环境变量
- 依赖MainStack顺序执行

## 主要功能

### Cognito集成(使用CDK自动构建)

- **用户池**在ESSENTIALS及以上套餐中支持Passkey认证
- **受管理的登录域**可定制的认证用户界面
- **应用程序客户端**启用ALLOW_USER_AUTH流程
- **OAuth 2.0**授权码模式(支持PKCE)

### 密码密钥认证

- 基于WebAuthn的无密码认证
- 支持生物识别(指纹、面部识别)或安全密钥
- 具有高钓鱼攻击抵抗力的安全认证方式

### FastMCP OIDC代理

- 通过OIDC发现自动与Cognito集成
- OAuth认证流程的自动化处理
- JWT(ID令牌)验证与会话管理
- 与MCP客户端的透明集成
- 支持动态客户端注册(DCR)

## 快速启动

### 前提条件

- Node.js 18及以上版本
- Python 3.12
- AWS CLI已配置
- AWS CDK CLI(`npm install -g aws-cdk`)

### 部署```bash
# 依存関係のインストール
npm install

# Pythonの依存関係をインストール
cd lambda
uv sync
cd ..

# CDKブートストラップ(初回のみ)
npx cdk bootstrap

# CDKのビルド
npm run build

# 両方のスタックを順番にデプロイ
npx cdk deploy --all

# または個別にデプロイ(MainStackが先に完了してからUpdateStackが実行される)
npx cdk deploy SampleOauthLambdaMcpStack
npx cdk deploy SampleOauthLambdaMcpUpdateStack

部署后的输出

部署完成后,将以以下JSON格式输出设置信息:```json
{
"mcpServerUrl": "https://xxxx.lambda-url.ap-northeast-1.on.aws/mcp",
"userPoolId": "ap-northeast-1_XXXXXXXXX",
"userPoolClientId": "xxxxxxxxxxxxxxxxxxxx",
"cognitoDomain": "mcp-oauth-xxx-xxx.auth.ap-northeast-1.amazoncognito.com",
"region": "ap-northeast-1",
"loginUrl": "https://mcp-oauth-xxx-xxx.auth.ap-northeast-1.amazoncognito.com/login?...",
"callbackUrl": "https://xxxx.lambda-url.ap-northeast-1.on.aws/oauth2/callback"
}


将输出保存到文件:```bash
cdk deploy --all --outputs-file outputs.json

或者,部署后获取:```bash

MainStackから設定情報を取得

aws cloudformation describe-stacks \
--stack-name SampleOauthLambdaMcpStack \
--query 'Stacks[0].Outputs[?OutputKey==Config].OutputValue' \
--output text | jq .

UpdateStackの状態を確認

aws cloudformation describe-stacks \
--stack-name SampleOauthLambdaMcpUpdateStack \
--query 'Stacks[0].Outputs'


## 架构```
┌─────────────┐
│ MCP Client  │
└─────┬───────┘
│
▼
┌─────────────────────┐
│ Lambda Function URL │
└─────────┬───────────┘
│
▼
┌─────────────────────┐
│   FastMCP Server    │
│  (with OAuthProxy)  │
└─────────┬───────────┘
│
▼
┌─────────────────────┐
│ Cognito User Pool   │
│ (Managed Login +    │
│  Passkey Auth)      │
└─────────────────────┘

认证流程

  1. MCP客户端向服务器发出请求
  2. 检测到FastMCP OIDCProxy未认证
  3. OIDCProxy自动处理客户端注册(DCR)
  4. 重定向到Cognito托管登录
  5. 用户通过密码密钥或密码进行认证
  6. 认证成功后,将重定向至回调URL
  7. OIDCProxy使用Cognito的JWKS来验证令牌
  8. 会话建立,允许访问MCP服务器

使用方法

用户创建```bash

デプロイ後の出力からuserPoolIdを取得

USER_POOL_ID=$(cat outputs.json | jq -r '.SampleOauthLambdaMcpStack.Config | fromjson | .userPoolId')

ユーザーを作成

aws cognito-idp admin-create-user \
--user-pool-id $USER_POOL_ID \
--username testuser \
--user-attributes Name=email,Value=test@example.com \
--temporary-password TempPass123!


### 密钥认证测试```bash
# ログインURLを取得
LOGIN_URL=$(cat outputs.json | jq -r '.SampleOauthLambdaMcpStack.Config | fromjson | .loginUrl')

# ブラウザで開く
open $LOGIN_URL

在Managed Login的用户界面注册密码密钥后,下次即可无需密码直接登录。

从MCP客户端连接```bash

MCPサーバーURLを取得

MCP_URL=$(cat outputs.json | jq -r '.SampleOauthLambdaMcpStack.Config | fromjson | .mcpServerUrl')

MCPクライアント設定に追加

echo $MCP_URL


FastMCP的OIDCProxy会自动处理认证流程。

## 限制事项

### 客户信息的持久化

在当前的实现中,MCP客户端的注册信息已传至Lambda`/tmp`已保存至目录:

**限制:**

- 在Lambda冷启动时`/tmp`数据丢失
- 虽然成功率高,但在完全冷启动时可能会失败
- 令牌过期后重新认证时,如果数据已消失则需要重新注册

**动作:**

- 冷启动→MCP客户端`/register`进行调用 `/tmp`进行保存
- 热启动 → `/tmp`数据保持正常 → 正常运行
- 完全冷启动(容器循环后)→ 数据丢失 → 需重新注册

**建议的改进:**

在生产环境中,建议将数据迁移到以下持久性存储:

1. **DynamoDB**最推荐(低成本、高可用性)```python
# カスタムDynamoDBStorageクラスを実装
client_storage = DynamoDBStorage(table_name="oauth-mcp-clients")
  1. S3简单实现(延迟稍高)```python
    client_storage = S3Storage(bucket_name="oauth-mcp-clients")

无论哪种情况`JSONFileStorage`只需替换它,无需更改其他代码。

## 故障排除

### “未找到客户端ID”错误

若Lambda冷启动后出现认证错误:```
{"error":"invalid_request","error_description":"Client ID 'xxx' not found"}

原因: /tmp客户端注册信息丢失

解决方法:

  1. 在MCP客户端清除缓存
  2. 重新连接(自动重新注册)

未显示密码密钥认证

  • 确认用户池的计划为ESSENTIALS及以上
  • 在应用程序客户端中ALLOW_USER_AUTH确认其有效性
  • 确认浏览器支持WebAuthn

令牌验证错误```bash

CloudWatch Logsでエラーログを確認

aws logs tail /aws/lambda/SampleOauthLambdaMcpStack-McpServerFunction --follow


- 确认环境变量已正确设置
- 确认令牌未过期
- OIDCProxy将使用Cognito的JWKS自动进行验证

### 部署错误```bash
# 全スタック削除
cdk destroy --all

# 再デプロイ
cdk deploy --all

若发生栈间依赖关系错误时:```bash

UpdateStackを先に削除

cdk destroy SampleOauthLambdaMcpUpdateStack

MainStackを削除

cdk destroy SampleOauthLambdaMcpStack

再デプロイ

cdk deploy --all


## 关于安全的注意事项

此样本为开发和验证用途。如需在生产环境中使用,请考虑以下事项:

1. **秘密管理**将客户端密钥保存到AWS Secrets Manager
1. **资源政策**将移除策略更改为保留
1. **日志**CloudWatch Logs的保留期设置
1. **监测**CloudWatch报警和X-Ray追踪
1. **WAF(Web Application Firewall,网络应用防火墙)**通过API Gateway或CloudFront启用WAF

## CDK命令```bash
# TypeScriptをコンパイル
npm run build

# 変更を監視
npm run watch

# CloudFormationテンプレートを生成(全スタック)
npx cdk synth

# 特定のスタックをシンセサイズ
npx cdk synth SampleOauthLambdaMcpStack

# デプロイ前に差分を確認
npx cdk diff --all

# 全スタックをデプロイ
npx cdk deploy --all

# 個別にデプロイ
npx cdk deploy SampleOauthLambdaMcpStack
npx cdk deploy SampleOauthLambdaMcpUpdateStack

# 全スタックを削除(UpdateStackから先に削除される)
npx cdk destroy --all

# 個別に削除(逆順で削除する必要がある)
npx cdk destroy SampleOauthLambdaMcpUpdateStack
npx cdk destroy SampleOauthLambdaMcpStack

参考资料

  • MCP OAuth规范
  • FastMCP OIDC代理
  • Cognito 管理的登录
  • Cognito密码密钥认证
  • AWS CDK Cognito 模块
  • Lambda执行环境的生命周期

许可证

此项目为示例代码。请随意使用和修改。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Sample Oauth Lambda MCP 怎么安装?

在客户端按下面的安装命令接入:npx cdk bootstrap。对应的包名是 cdk。装完在客户端配置里引用同一个包或端点。

Sample Oauth Lambda MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Sample Oauth Lambda MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Sample Oauth Lambda MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Sample Oauth Lambda MCP 能提供哪些能力?

资料显示能力标签包括 认证服务、服务器框架、TypeScript。具体工具清单以官方文档为准。

Sample Oauth Lambda MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Sample Oauth Lambda MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。