Dynamic MCP Poc

MCP浏览器工具

提供方 riposta

浏览器工具 stdio · 本地进程 API Key 社区 / 第三方
查看接入方式

一个基于MCP协议的认证网关,支持动态工具发现和按会话隔离的令牌交换功能。

一句话选型结论

按资料字段整理

Dynamic MCP Poc 属于浏览器工具类 MCP 服务器,stdio · 本地进程,API Key,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

HTML本地部署认证网关动态工具发现令牌交换会话隔离访问控制

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python -m venv .venv

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Dynamic MCP Poc当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

MCP网关——经过身份验证的动态工具发现

概念证明演示了一个经过身份验证的MCP(模型上下文协议)网关,该网关具有Keycloak、RFC 8693令牌交换和动态会话工具发现功能。

这有什么作用

AI代理连接到单个MCP网关。网关允许代理根据需要发现和激活工具服务器。每一跳都经过身份验证——用户通过Keycloak登录,网关将其令牌交换为服务器特定的令牌,每个MCP服务器验证其自己的作用域令牌。```
User (browser)
│
│ Keycloak OIDC login (PKCE)
▼
Web Frontend + ADK Agent (:8000)
│
│ Bearer token (aud: mcp-gateway)
▼
MCP Gateway (:8010)
│
│ Token exchange (RFC 8693)
▼
MCP Servers (:8011, :8012)
Each validates its own scoped token (aud: mcp-weather, mcp-calculator)


主要特点:

- **动态工具发现** --客服电话 `search_servers` / `enable_server` 在运行时
- **每会话隔离** --在某个会话中激活的服务器在另一个会话中不可见
- **代币兑换** --网关通过Keycloak将用户令牌交换为服务器特定的令牌
- **按用户访问控制** --Keycloak角色决定每个用户可以访问哪些服务器
- **无需更改代码即可添加服务器** --只需添加一个YAML条目和一个Keycloak客户端

## 先决条件

- Python 3.13+
- Docker(用于Keycloak)
- Node.js 18+(用于BDD测试)
- LLM API密钥(Vertex AI、Google AI Studio或OpenAI)

## 快速开始

### 1.克隆并设置Python环境```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2.配置环境```bash

cp .env.example .env


编辑 `.env` --按键设置为 `MODEL_NAME`:```bash
# Vertex AI (default, requires gcloud auth)
MODEL_NAME=vertex_ai/gemini-2.5-flash

# Or Google AI Studio (requires API key)
MODEL_NAME=gemini/gemini-2.0-flash
GOOGLE_API_KEY=your-key-here

3.开始一切```bash

make up


这将按顺序启动所有服务:Keycloak、配置令牌交换权限、MCP服务器、网关和web UI。它等待每个组件准备就绪,然后再开始下一个组件。

### 4.打开web UI

首选 **http://localhost:8000** 然后单击 **使用Keycloak登录**.

测试用户:

|用户|密码|访问|
|------|----------|--------|
| `testuser` | `testpass` |天气+计算器|
| `limiteduser` | `testpass` |仅天气|

登录后,您将被重定向到ADK聊天UI。让客服找到并使用可用的工具。

## 发出命令

|命令|描述|
|---------|-------------|
| `make up` |启动所有服务(Keycloak、服务器、网关、web UI)|
| `make down` |停止一切|
| `make status` |检查正在运行的服务|
| `make logs` |跟踪所有服务日志|
| `make test` |运行BDD测试套件|
| `make test-smoke` |仅运行烟雾测试|
| `make test-install` |安装BDD测试依赖项|

## 单独运行服务

如果您希望在单独的端子中启动组件:```bash
# Terminal 1: Keycloak
docker compose up -d
# Wait for Keycloak to be ready (~30s), then configure permissions:
bash keycloak/setup-permissions.sh

# Terminal 2: Weather server
source .venv/bin/activate
python servers/weather_server.py

# Terminal 3: Calculator server
source .venv/bin/activate
python servers/calculator_server.py

# Terminal 4: Gateway
source .venv/bin/activate
python gateway/server.py

# Terminal 5: Web UI
source .venv/bin/activate
python agent/web.py

端口映射

端口 组件
8080 钥匙斗篷(管理员: admin / admin)
8010 MCP网关
8011 气象MCP服务器
8012 计算器MCP服务器
8000 Web前端+ADK代理用户界面

运作原理

  1. 用户通过Keycloak登录(授权码+PKCE)
  2. 访问令牌(受众: mcp-gateway)被注入到代理的MCP呼叫中
  3. 客服电话 search_servers() 发现可用服务器
  4. 客服电话 enable_server("weather") --网关:
    - 检查用户的角色(access:weather)
    - 将令牌交换为一个范围为 mcp-weather
    - 连接到天气服务器,发现其工具
    - 在网关上注册代理工具
  5. 客服电话 get_weather("Warsaw") --网关:
    - 验证此会话中是否启用了服务器
    - 再次将令牌交换为新的服务器范围令牌
    - 将呼叫转发到天气服务器
    - 返回结果

每个MCP会话都有自己的一组启用的服务器。在一个浏览器选项卡中激活的工具不会出现在另一个选项卡中。

运行BDD测试

该项目使用Cucumber.js和TypeScript对正在运行的服务进行黑盒BDD测试。```bash

Install test dependencies (once)

make test-install

Start all services

make up

Run tests

make test


## 项目结构```
MCPTest/
├── gateway/
│   ├── server.py              # MCP gateway with auth + token exchange + per-session state
│   └── servers.yaml           # Server registry (name, URL, audience, role)
├── servers/
│   ├── weather_server.py      # Weather MCP server (JWT auth)
│   └── calculator_server.py   # Calculator MCP server (JWT auth)
├── agent/
│   ├── __init__.py            # Exports root_agent
│   ├── main.py                # ADK agent with MCP toolset + header_provider
│   └── web.py                 # FastAPI: Keycloak login + ADK Web UI
├── keycloak/
│   ├── mcp-poc-realm.json     # Realm config (clients, scopes, mappers, users)
│   └── setup-permissions.sh   # Configures V1 fine-grained token exchange permissions
├── tests/bdd/                 # Cucumber.js BDD test suite
│   ├── features/              # Gherkin scenarios
│   ├── steps/                 # TypeScript step definitions
│   └── support/               # World class
├── doc/
│   ├── ARCHITECTURE.md        # Architecture overview
│   ├── IMPLEMENTATION.md      # Implementation details
│   └── IMPLEMENTATION-BDD.md  # BDD test approach
├── docker-compose.yml         # Keycloak container
├── Makefile                   # Service orchestration
├── requirements.txt           # Python dependencies
└── .env.example               # Environment template

添加新的MCP服务器

  1. 钥匙斗篷 --添加仅承载客户端(mcp-),一个受众范围,并将其分配给 mcp-gateway
  2. 服务器代码 --创建 servers/_server.py 随着 JWTVerifier(audience="mcp-")
  3. 网关配置 --向添加条目 gateway/servers.yaml
  4. 重启 网关——网关或代理中不需要更改代码

看 doc/IMPLEMENTATION.md 第10节了解全部细节。

文档

  • 建筑 --组件设计、信任边界、令牌流
  • 实施 --代码结构、Keycloak设置、关键API
  • BDD测试 --测试方法、场景目录

限制(PoC)

  • 仅内存状态--重新启动时丢失
  • 无令牌刷新——令牌过期后(1小时)用户必须重新登录
  • 通过全局变量进行单用户web会话
  • 无TLS——所有流量都是明文HTTP

常见问题

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

在客户端按下面的安装命令接入:python -m venv .venv。装完在客户端配置里引用同一个包或端点。

Dynamic MCP Poc 怎么在客户端里配置?

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

Dynamic MCP Poc 收费吗?

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

Dynamic MCP Poc 需要 API Key 吗?

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

Dynamic MCP Poc 能提供哪些能力?

资料显示能力标签包括 访问控制、HTML、浏览器自动化。具体工具清单以官方文档为准。

Dynamic MCP Poc 需要什么运行环境?

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

Dynamic MCP Poc 是本地还是远程?

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

热门专题

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

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