
Conduktor
io.github.conduktorv1.0.1更新于 Oct 6, 2026
Read-only Kafka access for AI assistants: topics, consumer groups, schemas, cluster health.
概览
通过 Conduktor Console 以只读方式访问 Kafka 元数据:主题、消费者组、Schema 和集群健康状态。
- 功能
- 将 MCP 客户端连接到您自己的 Conduktor Console 实例,并提供只读的 Kafka 工具。可列出集群和带用量指标的主题,查看消费者组的状态与积压,列出 Schema 主题名称,并给出集群与主题洞察,例如分区倾斜和副本问题。其中一个工具 get-last-messages 可读取某个主题最近最多 100 条消息。
- 适用场景
- 适合需要让助手了解 Kafka 平台运行状况的场景:归属、积压、倾斜、Schema 和集群健康。适用于已经运行 Conduktor Console、希望用自然语言查看集群而无需额外部署的团队。
- 运行要求
- 需要一个 Conduktor Console 实例,以及在 Console 中创建的 Personal Access Token,通过 CONDUKTOR_API_TOKEN 提供,并在 CONDUKTOR_CONSOLE_URL 中填写 Console 基础地址。可作为本地 npm 包(@conduktor/mcp,通过 npx)运行,也可作为远程端点连接您的 Console 主机并使用 Authorization 请求头。需要能访问您的 Console。
安装
在 SourceWeft 中
- 打开 控制台中的 Conduktor,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"kafka-mcp": {
"type": "http",
"url": "https://{console_host}/api/mcp"
}
}
}README
Conduktor MCP Server
An MCP server for Apache Kafka, built into Conduktor Console.
Connect Claude, Cursor, or any MCP-compatible client to your Kafka clusters and ask about topics, consumer groups, schemas and cluster health in natural language. Metadata is served by your own Console instance, so it stays inside your network.
There is nothing to deploy. The MCP endpoint ships with Console, behind the RBAC, audit trail and ownership rules you already run — which is what makes giving an assistant real access reasonable in the first place.
Setup
Create a Personal Access Token in Console, then point your MCP client at your own Console:
Replace console.acme-corp.com with your own Console hostname. /api/mcp is appended for you,
and pasting a URL that already ends in it works too.
To check your settings before wiring up a client:
Connecting without the package
@conduktor/mcp wraps mcp-remote. You can call it
yourself if you prefer:
Tools
Control plane, not data plane
What reaches the model is metadata: topics, configs, offsets, consumer groups, schemas,
connectors, audit. Your records stay in Kafka unless a tool that reads them is explicitly in
play — get-last-messages is the only one above that touches the data plane, and it is capped.
That distinction is the point. An assistant that reasons about how your platform is run needs ownership, lag, skew and history. It does not need your customers' payloads.
One endpoint, two kinds of client
The same MCP catalogue serves your own tools — Claude Code, Cursor, a script, your internal developer platform — and the agents Conduktor runs inside Console on a schedule or on an audit-log event. Same tools, same RBAC, same audit trail, whether the caller is a human at a terminal or an unattended task running at 9am on a Monday.
Which matters more than it sounds: it means automating a Kafka chore does not require handing a service account to a script. It goes through the same bounded identity as everything else.
What's next
The table above is what ships today, and it is deliberately the read-only slice.
The surface is expanding towards agents that do the operational work — finding reclaimable topics, attributing cost, chasing unowned topics, nursing failed connectors — and towards write operations, where the assistant proposes a mutation with its intent stated and a human signs it off. Acting, not just reporting.
Watch the release notes for what lands when.
Permissions
The tools listed above are read-only.
The server acts as the user behind the token: it inherits that user's Console RBAC, and can only reach clusters, topics and subjects that user is already allowed to read. Scope the token to what you intend the assistant to see.
RBAC is what holds when write lands, which is the point of running this through Console rather than against the brokers: permissions, audit and ownership are already there.
Documentation
What is in this repository
The launcher published as @conduktor/mcp,
this documentation, and the registry metadata (server.json).
The MCP server itself runs inside Conduktor Console and is not open source. For bugs in the server, use Conduktor support; for anything about the launcher or these docs, open an issue here.
来源:README.md,提交 a711355
工具
0版本历史
1- v1.0.1最新Oct 6, 2026

