Conduktor

io.github.conduktorv1.0.1更新于 Oct 6, 2026

Read-only Kafka access for AI assistants: topics, consumer groups, schemas, cluster health.

已验证Streamable HTTP可网页运行DatabasesData & AnalyticsSecurity & Monitoring

概览

AI 生成的概览

通过 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。
安装前请注意
该令牌以对应用户身份行事并继承其 Console RBAC 权限,请按助手实际需要可见的范围进行限制。文档中的工具为只读,但 get-last-messages 会读取主题中的真实消息内容,可能包含敏感数据。服务器本身运行在 Console 内,并非开源。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Conduktor,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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.

[One endpoint for your tools and for Console agents. Every call carries a Console token, runs under that user's RBAC, is read-only and is audited. Only metadata reaches the model — your records stay in Kafka.]

Setup

Create a Personal Access Token in Console, then point your MCP client at your own Console:

json
{  "mcpServers": {    "conduktor": {      "command": "npx",      "args": ["-y", "@conduktor/mcp"],      "env": {        "CONDUKTOR_CONSOLE_URL": "https://console.acme-corp.com",        "CONDUKTOR_API_TOKEN": "your-personal-access-token"      }    }  }}

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:

bash
CONDUKTOR_CONSOLE_URL=https://console.acme-corp.com \CONDUKTOR_API_TOKEN=<token> \npx -y @conduktor/mcp
Connecting without the package

@conduktor/mcp wraps mcp-remote. You can call it yourself if you prefer:

json
{  "mcpServers": {    "conduktor": {      "command": "npx",      "args": [        "mcp-remote",        "https://console.acme-corp.com/api/mcp",        "--header",        "Authorization: Bearer ${CONDUKTOR_API_TOKEN}"      ],      "env": { "CONDUKTOR_API_TOKEN": "your-personal-access-token" }    }  }}

Tools

ToolWhat it does
list-clustersList all Kafka clusters available in Conduktor
get-clusterGet details about a specific cluster by its slug
list-topics-with-usageList topics with usage metrics (message count, size, rates)
get-last-messagesRetrieve the last N messages from a topic (up to 100)
insights-clusterCluster health summary and serialization format breakdown
insights-topicsTopic insights — partition skew, replication issues
list-subject-namesList subject names in a cluster, filterable by schema type
list-consumer-groupsList consumer groups with state, lag and member count
list-consumer-groups-by-topicList consumer groups consuming from a specific topic
list-interceptorsList interceptors configured in a cluster (requires Conduktor Gateway)

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
  1. v1.0.1最新Oct 6, 2026