MCP Auth Demo 140b40f1

MCP安全风控

提供方 florenm2

安全风控 未标注 OAuth 授权 社区 / 第三方

一个实现Model Context Protocol (MCP)授权流程的概念验证,包含MCP服务器和客户端,支持动态客户端注册(DCR)、OAuth授权/令牌端点以及基于SSE的MCP传输。

一句话选型结论

按资料字段整理

MCP Auth Demo 140b40f1 属于安全风控类 MCP 服务器,传输方式未标注,OAuth 授权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

授权协议TypeScript本地部署OAuth动态客户端注册SSE传输概念验证

安装与配置

未标注 OAuth 授权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

日志与审计

汇总日志、查异常行为。

合规检查

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

选择建议

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

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Auth Demo 140b40f1当前 2 未标注 未标注 无 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

服务器档案

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

详细介绍

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

MCP Auth Demo

A proof-of-concept implementation of the Model Context Protocol (MCP) authorization flow featuring:

  • MCP server (server/) exposing Dynamic Client Registration (DCR), OAuth authorization/token endpoints, and an SSE-based MCP transport guarded by bearer tokens.
  • MCP client (client/) that automatically self-registers via DCR, performs the OAuth flow, caches credentials/tokens, and connects to the server to exercise authenticated tools.

Prerequisites

  • Node.js ≥ 18
  • npm

Frameworks & Key Versions

Library / Tool Version Role / Rationale
Express ^5.1.0 Lightweight HTTP framework for wiring OAuth endpoints and SSE transport quickly. v5 gives us async handler support out of the box.
@modelcontextprotocol/sdk ^1.22.0 Provides canonical MCP server + client implementations and transport helpers so we stay spec-compliant without rebuilding the protocol stack.
Zod ^3.25.76 Runtime validation for DCR/OAuth payloads and tool schemas; makes error messaging explicit.
TypeScript ^5.9.3 Ensures strict typing across both server and client for better safety in the auth flow.
tsx ^4.20.6 Zero-config TS/ESM runner for local development scripts (dev:server, dev:client).

Installation```bash

npm install


## Running the Server```bash
npm run dev:server

Defaults:

  • Base URL: http://localhost:3333
  • Automatically registers two tools:
  • whoami: returns the MCP context of the caller.
  • read-secret: returns a protected secret, requires secret.read scope.

Environment variables (optional):

Variable Description Default
PORT Server port 3333
PUBLIC_BASE_URL External base URL (used in metadata + OAuth responses) http://localhost:${PORT}
SERVER_SECRET Value returned by read-secret demo-mcp-secret
DEMO_USER_ID / DEMO_USER_NAME Mock user identity used during authorization demo-user / Demo User

Running the Client```bash

npm run dev:client


What happens:

1. Checks `.mcp-auth/clients.json` for an existing registration per base URL. If missing/invalid, registers a new client via `/dcr/register`.
2. Looks for a valid cached access token in `.mcp-auth/tokens.json`. If expired or missing, runs the OAuth authorize + token exchange flow (using `prompt=auto` and manual redirect handling, so no browser interaction is required).
3. Connects to the MCP server via `SSEClientTransport`, lists tools, calls `whoami`, then calls `read-secret` (if scope available).

The CLI automatically recovers from stale client registrations (e.g., if the server was restarted and forgot previous client IDs).

Client environment variables:

| Variable | Description | Default |
| --- | --- | --- |
| `SERVER_BASE_URL` | Base URL of the MCP server | `http://localhost:3333` |
| `CLIENT_REDIRECT_URI` | Redirect URI used during OAuth | `http://localhost:4321/callback` |
| `CLIENT_SCOPES` | Scopes to request during DCR/OAuth | `mcp:invoke secret.read` |
| `CLIENT_STORAGE_DIR` | Root directory for cached credentials | `${PWD}/.mcp-auth` |
| `CLIENT_STORAGE_PATH` | Override path for cached client registrations | `${CLIENT_STORAGE_DIR}/clients.json` |
| `TOKEN_STORAGE_PATH` | Override path for cached tokens | `${CLIENT_STORAGE_DIR}/tokens.json` |
| `TOKEN_LEEWAY_MS` | Expiry leeway before reusing a cached token | `60000` (1 minute) |

⚠️ `.mcp-auth/` is ignored by git; delete it to force a fresh registration and token.

## Manual Testing via curl/Postman

You can drive each step manually if desired:

1. **DCR**: `POST /dcr/register` with a JSON payload to receive `client_id` + `client_secret`.
2. **Authorization**: `GET /oauth/authorize?client_id=...&response_type=code&prompt=auto...` and inspect the redirect URL to capture `code`.
3. **Token Exchange**: `POST /oauth/token` (form-encoded) with the authorization code.
4. **MCP**: Use the `access_token` in `Authorization: Bearer ...` headers to call `GET /mcp` (establish SSE) and `POST /mcp/messages?sessionId=...` for JSON-RPC requests.

## Testing Guide

### Server-only Checks

1. **Health + Metadata**```bash
   curl http://localhost:3333/healthz
   curl http://localhost:3333/.well-known/oauth-authorization-server
   ```
2. **DCR Validation**```bash
   curl http://localhost:3333/dcr/register \
     -H "Content-Type: application/json" \
     -d '{"client_name":"curl-test","redirect_uris":["http://localhost:9999/callback"],"scope":"mcp:invoke"}'
   ```
3. **OAuth Flow (manual)**
   - Hit `/oauth/authorize?client_id=...&response_type=code&prompt=auto...`
   - Exchange code via `/oauth/token`.
4. **Protected MCP endpoints**
   - `GET /mcp` and `POST /mcp/messages` with the bearer token to ensure authorization middleware works.

### Client-only Checks

1. Clear caches: `rm -rf .mcp-auth`
2. Run `npm run dev:client`
   - Verify it registers, authorizes, and prints tool responses.
3. Run again to confirm cached client + token reuse.
4. (Optional) Remove `.mcp-auth/clients.json` only to confirm re-registration handling.

### Full End-to-End Test

1. `npm run dev:server`
2. In another terminal: `npm run dev:client`
3. Confirm logs show tool list, `whoami`, and `read-secret` outputs.
4. Optionally, drive additional tool calls via curl/Postman using the issued `access_token`.

## Repo Structure```
server/
  auth.ts          # In-memory DCR + OAuth storage + bearer middleware
  index.ts         # Express app exposing OAuth + MCP endpoints/tools
client/
  app.ts           # CLI entry point
  config.ts        # Configuration & environment defaults
  dcr.ts           # Client registration logic
  oauth.ts         # Authorization-code flow
  tokenManager.ts  # Token caching & refresh heuristics
  mcp.ts           # SSE client transport & demo tool invocations
  storage.ts       # File-based persistence helpers
  utils/           # Logging + HTTP helpers

Future Enhancements

  • Interactive CLI commands for arbitrary tool calls.
  • Browser-based OAuth with PKCE and an embedded loopback callback server.
  • Persisted refresh tokens / long-lived sessions.
  • Automated tests covering the full DCR → OAuth → MCP roundtrip.

Feel free to tweak scopes, add new tools, or point the client at a remotely hosted MCP server to experiment with enterprise-style deployments.

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP Auth Demo 140b40f1 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Auth Demo 140b40f1 怎么在客户端里配置?

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

MCP Auth Demo 140b40f1 收费吗?

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

MCP Auth Demo 140b40f1 需要 API Key 吗?

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

MCP Auth Demo 140b40f1 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 TypeScript、SSE传输、安全。具体工具清单以官方文档为准。

热门专题

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

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