Asyncapi MCP Gen

MCP开发工具

提供方 cdev-76

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 ClaudeCursor
查看接入方式

基于AsyncAPI规范自动生成Python Kafka MCP服务器的工具,支持多种安全协议集成。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

KafkaPython本地部署AsyncAPI代码生成事件驱动架构安全协议

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
uv run fastmcp dev mcp_server.py # development mode (MCP Inspector)

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Asyncapi MCP Gen当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

AsyncAPI MCP Kafka生成器

自定义AsyncAPI生成器模板,自动生成 模型上下文协议(MCP) Python中的服务器,来自AsyncAPI v3规范。

目标是让LLM(Claude、Cursor等)使用AsyncAPI规范作为唯一的真实来源,与基于Kafka的事件架构进行交互。


运作原理```

AsyncAPI spec (.yaml)
│
▼
AsyncAPI Generator + template/
│
▼
generated-code/
├── mcp_server.py ← FastMCP server with one @mcp.tool per send operation
└── kafka_producer.py ← Confluent Kafka producer with Schema Registry


对于每一个 `send` 在规范中定义的操作中,生成器创建了一个类型化的Python函数,用 `@mcp.tool`该函数根据从规范中提取的JSON模式验证和序列化有效载荷,然后将消息生成到相应的Kafka主题。

从读取安全配置(代理主机、身份验证方案) `servers[]` 规范的一部分,并直接嵌入到生成的代码中。

______________________________________________________________________

## 项目结构```
.
├── template/
│   ├── mcp_server.js              # Dynamic template (AsyncAPI React SDK) → generates mcp_server.py
│   └── kafka_producer.py          # Static file — copied as-is to generated-code/
├── yaml/                          # AsyncAPI v3 spec examples
│   ├── streets-lights.yaml        # PLAINTEXT + SCRAM-SHA-256 servers
│   ├── streets-lights-oauth.yaml  # OAuth2 client_credentials server
│   └── temperature.yaml           # IoT temperature sensors, PLAINTEXT
├── generated-code/                # Output of the generator (gitignored — regenerate as needed)
│   ├── mcp_server.py
│   └── kafka_producer.py
├── consumer/                      # Standalone Kafka consumer for testing/observability
│   ├── kafka_consumer.py
│   └── run_consumer.py
├── docker/                        # Local dev environment
│   ├── docker-compose.yml         # Kafka SASL_SSL (SCRAM) + Schema Registry (Basic Auth) + nginx
│   ├── docker-compose-plain.yml   # Kafka PLAINTEXT only — for quick local testing
│   ├── docker-compose-oauth.yml   # Kafka SASL_SSL (OAUTHBEARER) + Schema Registry (Basic Auth) + Keycloak
│   ├── keycloak-realm.example.json  # Keycloak realm config template (copy to keycloak-realm.json)
│   ├── gen-certs.sh               # Generates SSL certs for SASL_SSL listeners (run once)
│   ├── kafka-init.sh              # Creates SCRAM users at broker startup
│   └── launch.sh                  # Interactive launcher — choose which stack to bring up
├── api/                           # FastAPI service that wraps the generator (REST interface)
│   └── app.py
├── scripts/
│   ├── run_asyncapi_generator.sh  # Wrapper around asyncapi generate
│   └── run_mcp_inspector.sh       # Launches the MCP Inspector UI
├── package.json                   # AsyncAPI generator template config
└── pyproject.toml                 # Python dependencies (uv)

先决条件

  • Node.js (用于AsyncAPI生成器)
  • Python≥3.13 + 紫外线
  • Docker+Docker组合 (适用于本地Kafka堆栈)

安装AsyncAPI生成器和Python依赖项:```bash
npm install
uv sync


______________________________________________________________________

## 生成MCP服务器

使用提供的脚本,传递规范文件和服务器名称(可选):```bash
./scripts/run_asyncapi_generator.sh yaml/streets-lights.yaml plain-connections

这 server 参数选择在生成的代码中嵌入哪个代理主机和安全方案。如果省略,则使用规范中的第一个服务器。

符合规范的可用服务器:

规格 服务器名称 安全性
streets-lights.yaml plain-connections 无(PLAINTEXT)
streets-lights.yaml scram-connections SCRAM-SHA-256
streets-lights-oauth.yaml oauth-connections OAuth2客户端_凭据

当地发展环境

以交互方式启动堆栈:```bash
cd docker/
bash launch.sh


有三种堆栈可供选择:

|堆栈|编写文件|端口|服务|
|-------|-------------|------|----------|
|明文| `docker-compose-plain.yml` |9092 | Kafka+模式注册表(打开)+Kafka-ui|
|紧急停堆| `docker-compose.yml` |9095| Kafka(SASL_SSL+SCRAM-SHA-256)+模式注册表(基本认证)+Kafka-ui+nginx|
|OAuth2| `docker-compose-oauth.yml` |9095| Kafka(SASL_SSL+OAUTHBEARER)+模式注册表(基本认证)+Kafka-ui+Keycloak|

对于SCRAM和OAuth2堆栈,首先生成SSL证书(只需要一次):```bash
cd docker/
bash gen-certs.sh

OAuth2/钥匙斗篷设置

OAuth2堆栈需要 docker/keycloak-realm.json 文件(gitignored)。复制示例并设置您的客户端密码:```bash
cp docker/keycloak-realm.example.json docker/keycloak-realm.json

Edit keycloak-realm.json and replace "CHANGE_ME" with a real secret


王国(`masorange`)和客户(`mcp-app`)在首次启动时自动导入。不需要手动Keycloak配置。

______________________________________________________________________

## 运行生成的MCP服务器

配置 `generated-code/.env` 为您的安全方案设置适当的变量:```env
SCHEMA_REGISTRY_URL=http://localhost:8081

# PLAINTEXT — no extra config needed

# SCRAM-SHA-256
KAFKA_USERNAME=testuser
KAFKA_PASSWORD=testpassword
KAFKA_SSL_CA_LOCATION=../docker/certs/ca.crt

# OAuth2 client_credentials
OAUTH_CLIENT_ID=mcp-app
OAUTH_CLIENT_SECRET=your-secret
OAUTH_TOKEN_URL=http://localhost:9090/realms/masorange/protocol/openid-connect/token

# Schema Registry Basic Auth (SCRAM and OAuth2 stacks only — not needed for PLAINTEXT)
SCHEMA_REGISTRY_USERNAME=admin
SCHEMA_REGISTRY_PASSWORD=testpassword

运行服务器:```bash
cd generated-code/
uv run fastmcp dev mcp_server.py # development mode (MCP Inspector)
uv run mcp_server.py # production mode


______________________________________________________________________

## 通过安全方案快速启动

### 明文

不需要证书或凭据。```bash
# 1. Start the stack
cd docker && bash launch.sh   # option 1

# 2. Generate the MCP server
./scripts/run_asyncapi_generator.sh yaml/streets-lights.yaml plain-connections

# 3. Run
cd generated-code && uv run mcp_server.py

SCRAM-SHA-256```bash

1. Generate SSL certificates (broker only — run once)

cd docker && bash gen-certs.sh

2. Start the stack

bash launch.sh # option 2

3. Generate the MCP server

./scripts/run_asyncapi_generator.sh yaml/streets-lights.yaml scram-connections

4. Configure generated-code/.env

KAFKA_USERNAME=testuser
KAFKA_PASSWORD=testpassword
KAFKA_SSL_CA_LOCATION=../docker/certs/ca.crt
SCHEMA_REGISTRY_URL=http://localhost:8081
SCHEMA_REGISTRY_USERNAME=admin
SCHEMA_REGISTRY_PASSWORD=testpassword

5. Run

cd generated-code && uv run mcp_server.py


______________________________________________________________________

### OAuth2(客户端证书)```bash
# 1. Set up the Keycloak realm
cp docker/keycloak-realm.example.json docker/keycloak-realm.json
# Edit keycloak-realm.json and replace "CHANGE_ME" with a real client secret

# 2. Generate SSL certificates (broker only — run once)
cd docker && bash gen-certs.sh

# 3. Start the stack
bash launch.sh   # option 3

# 4. Generate the MCP server
./scripts/run_asyncapi_generator.sh yaml/streets-lights-oauth.yaml oauth-connections

# 5. Configure generated-code/.env
KAFKA_SSL_CA_LOCATION=../docker/certs/ca.crt
SCHEMA_REGISTRY_URL=http://localhost:8081
SCHEMA_REGISTRY_USERNAME=admin
SCHEMA_REGISTRY_PASSWORD=testpassword
OAUTH_CLIENT_ID=mcp-app
OAUTH_CLIENT_SECRET=
OAUTH_TOKEN_URL=http://localhost:9090/realms/masorange/protocol/openid-connect/token

# 6. Run
cd generated-code && uv run mcp_server.py

安全支持

从规范中读取安全配置 servers[].security 字段并嵌入生成的 mcp_server.py.

AsyncAPI方案 Kafka协议 身份验证
(无) PLAINTEXT 无
scramSha256 SASL_SSL SCRAM-SHA-256(用户名+密码)
oauth2 / clientCredentials SASL_SSL OAUTHBEARER——通过客户端密钥获取M2M令牌

OAuth2客户端_凭证流

MCP服务器使用 client_id + client_secret无需人工干预——只要Kafka客户端需要,令牌就会在后台自动获取。Kafka代理根据Keycloak的JWKS端点验证JWT签名,并检查 iss 和 aud 声称。

这非常适合MCP服务器:生产者是一个具有自己的应用程序身份的自动化服务,而不是人类用户。


使用的AsyncAPI规范功能

路径参数

通道地址参数(例如。 {streetlightId})被提取并作为函数参数公开。默认情况下,第一个路径参数用作Kafka分区键。

自定义分区密钥(x-kafka-key)

用以下命令覆盖分区键字段 x-kafka-key 操作扩展:```yaml
operations:
sendReading:
action: send
x-kafka-key: sensorId
channel:
$ref: '#/channels/readingsChannel'


### 可选字段

有效载荷属性未在以下列出 `required` 生成为 `Optional[T] = None` 并在发送前过滤掉。

### 文档字符串

生成的工具函数包括从以下内容构建的文档字符串 `summary`, `description`和财产 `description` 规范中的字段。

______________________________________________________________________

## 消耗事件(可观察性)

提供了一个简单的消费者进行测试。通过配置 `consumer/.env`:```env
KAFKA_BOOTSTRAP_SERVERS=localhost:9095
TOPICS=smartylighting.streetlights.1.0.action.home.turn.on
CONSUMER_GROUP_ID=streetlights-logger
KAFKA_USERNAME=testuser
KAFKA_PASSWORD=testpassword
KAFKA_SSL_CA_LOCATION=../docker/certs/ca.crt
``````bash
cd consumer/
uv run run_consumer.py

示例规格

文件 服务器 描述
yaml/streets-lights.yaml plain-connections (9092), scram-connections (9095) 路灯API-路径参数、PLAINTEXT和SCRAM
yaml/streets-lights-oauth.yaml oauth-connections (9095) 路灯API-OAuth2客户端_凭证
yaml/temperature.yaml (普通) 物联网温度传感器——必填字段,无身份验证

常见问题

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

在客户端按下面的安装命令接入:uv run fastmcp dev mcp_server.py # development mode (MCP Inspector)。装完在客户端配置里引用同一个包或端点。

Asyncapi MCP Gen 怎么在 Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Asyncapi MCP Gen 收费吗?

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

Asyncapi MCP Gen 需要 API Key 吗?

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

Asyncapi MCP Gen 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Asyncapi MCP Gen 能提供哪些能力?

资料显示能力标签包括 安全协议、Python、Claude、代码生成。具体工具清单以官方文档为准。

Asyncapi MCP Gen 需要什么运行环境?

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

Asyncapi MCP Gen 是本地还是远程?

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

热门专题

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

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