# KafDesk

> KafDesk is an MCP server for developer tools. Local Kafka MCP server: topics, messages, consumer lag and schemas, read-only by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, self-hosted
- **Website:** https://kafdesk.com/kafka-mcp-server
- **MCP Registry name:** com.kafdesk/kafdesk-mcp
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

The server reuses the cluster connections you already saved in the KafDesk desktop app, so the agent never sees a password; credentials come from your KafDesk connections and the OS keychain. Output is capped so a large topic cannot flood the agent, KafDesk's masking rules apply to every record read, and cluster data is flagged as untrusted input in tool descriptions. Every call is logged on your computer.

Beyond browsing topics, it explains consumer lag by naming causes such as stopped consumers, rebalances, one hot partition or stalled commits, shows replica and leader placement per broker and rack, compares two topics by key and compares schema versions. Protobuf can be decoded from local .proto files.

Writes exist only if you allow them. With writes set to Ask, produce, offset resets and topic config changes appear in the KafDesk window for you to Allow or Deny, and unanswered requests are refused after 60 seconds.

## Features

- **Consumer lag explanation:** explain_consumer_lag names why a group is behind.
- **Partition placement:** Shows replicas, leaders, under-replicated and offline partitions.
- **Bounded message sampling:** Sample and find records by key with capped output.
- **Topic comparison:** Compare two topics by key, for example after a copy.
- **Approval-gated writes:** Produce, offset reset and config changes need your Allow in the app.
- **Local audit log:** Every call is recorded on your machine.

## Good for

- Find out why a consumer group is lagging
- Check whether partitions are under-replicated
- Verify a topic copy by comparing keys
- Compare two versions of a schema
- Plan an offset reset for review

## Install

### Claude Code (Terminal)

```sh
claude mcp add kafdesk-mcp -- npx -y https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kafdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kafdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kafdesk-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kafdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kafdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb"
      ]
    }
  }
}
```

## Tools

- `list_clusters`: Lists saved clusters.
- `cluster_overview`: Overview of a cluster.
- `list_topics`: Lists topics.
- `describe_topic`: Describes a topic.
- `partition_placement`: Replicas and leaders per broker and rack, plus problem partitions.
- `consume`: Bounded, decoded message samples.
- `find_messages_by_key`: Finds messages by key.
- `compare_topics`: Compares two topics by key without values.
- `list_groups`: Lists consumer groups.
- `describe_group`: Describes a consumer group.
- `explain_consumer_lag`: Explains why a group is lagging.
- `compare_schema_versions`: Compares schema versions.
- `reset_offsets`: Plans an offset reset; applies only when writes are allowed.

## FAQ

### Can the agent change my cluster?

Not by default. Writes need Ask mode, and each change needs your Allow in KafDesk.

### Where do credentials come from?

From your KafDesk connections and the OS keychain; the agent never sees passwords.

### How do I add it to Claude Code or Cursor?

Open AI agents in KafDesk and click the client; other clients can run the kafdesk-mcp binary over stdio.

### Is there a trial?

KafDesk offers a 14-day free trial.

### Is KafDesk free?

KafDesk is a paid product with a free trial.

### How do I add KafDesk to Claude Code?

Run this command in your terminal: claude mcp add kafdesk-mcp -- npx -y https://github.com/kafdesk/releases/releases/download/v0.2.9/kafdesk-mcp-0.2.9.mcpb

### What are the best alternatives to KafDesk?

The closest alternatives to KafDesk are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kafdesk
