AKHQ MCP Server
Allows AI assistants to interact with Apache Kafka clusters via AKHQ's REST API, providing tools for managing topics, consumer groups, schema registry, nodes/brokers, Kafka Connect, ksqlDB, and ACLs.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AKHQ MCP Serverlist all topics in the dev environment"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AKHQ MCP Server
An MCP (Model Context Protocol) server for AKHQ — the GUI for Apache Kafka.
Enables AI assistants (Claude, Cursor, etc.) to interact with Kafka clusters through AKHQ's REST API.
Features
Multi-environment support — configure multiple AKHQ instances (dev, staging, prod) and switch between them at runtime
Flexible authentication — supports no auth, HTTP Basic auth, and Bearer auth
Comprehensive AKHQ API coverage — topics, consumer groups, schema registry, nodes/brokers, Kafka Connect, ksqlDB, ACLs
Related MCP server: KafkaIQ
Installation
npm install
npm run buildOr run directly via npx:
{
"mcpServers": {
"akhq": {
"command": "npx",
"args": ["akhq-mcp-server"]
}
}
}Configuration
Option 1: Config file (recommended for multiple environments)
Set the AKHQ_CONFIG_FILE environment variable to point to a JSON config file:
AKHQ_CONFIG_FILE=/path/to/akhq-config.json npx akhq-mcp-serverExample config file (akhq-config.json):
{
"environments": [
{
"name": "local",
"baseUrl": "http://localhost:8080",
"auth": { "type": "none" }
},
{
"name": "dev",
"baseUrl": "https://akhq-dev.example.com",
"auth": {
"type": "basic",
"username": "admin",
"password": "secret"
}
},
{
"name": "prod",
"baseUrl": "https://akhq-prod.example.com",
"auth": {
"type": "bearer",
"token": "eyJhbGci..."
}
}
],
"defaultEnvironment": "local"
}Auth types:
"none"— no authentication"basic"— HTTP Basic authentication (username + password)"bearer"— Bearer authentication
Option 2: Environment variables (single environment)
Variable | Description | Default |
| Base URL of your AKHQ instance |
|
| Name for this environment |
|
| Auth type: |
|
| Username (for | |
| Password (for | |
| Bearer token (for |
Example with basic auth:
AKHQ_BASE_URL=https://akhq.example.com \
AKHQ_AUTH_TYPE=basic \
AKHQ_AUTH_USERNAME=admin \
AKHQ_AUTH_PASSWORD=secret \
node dist/main.jsMCP Client Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"akhq": {
"command": "node",
"args": ["/path/to/akhq-mcp-server/dist/main.js"],
"env": {
"AKHQ_CONFIG_FILE": "/path/to/akhq-config.json"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project or globally:
{
"mcpServers": {
"akhq": {
"command": "node",
"args": ["/path/to/akhq-mcp-server/dist/main.js"],
"env": {
"AKHQ_BASE_URL": "http://localhost:8080"
}
}
}
}Available Tools
Environment Management
Tool | Description |
| List all configured AKHQ environments |
| Switch the active AKHQ environment |
| Get the currently active environment |
General
Tool | Description |
| Get all auth details for current instance |
| Get all cluster info |
| Get current user info |
| Get default topic configuration |
Topics
Tool | Description |
| List all topics |
| Create a new topic |
| Get topic details |
| Delete a topic |
| Get topic configuration |
| Update topic configuration |
| Get topic messages |
| Produce a message to a topic |
| Delete records from a topic |
| Get ACLs for a topic |
Consumer Groups
Tool | Description |
| List all consumer groups |
| Get consumer group details |
| Delete a consumer group |
| Get consumer group offsets |
| Update consumer group offsets |
| Get ACLs for a consumer group |
| Get consumer group members |
| Get topics for a consumer group |
Schema Registry
Tool | Description |
| List all schemas |
| Create a new schema |
| Get schema by subject |
| Delete a schema |
| Get all versions of a schema |
| Get a specific schema version |
Nodes / Brokers
Tool | Description |
| List all nodes |
| Get node details |
| Get node configuration |
| Update node configuration |
| Get node log configuration |
Kafka Connect
Tool | Description |
| List all connectors |
| Create a connector |
| Get connector details |
| Delete a connector |
| Get connector configuration |
| Update connector configuration |
| Pause a connector |
| Resume a connector |
| Restart a connector |
| Get connector tasks |
| Restart a connector task |
| List connect plugins |
ksqlDB
Tool | Description |
| Get ksqlDB server info |
| List ksqlDB queries |
| List ksqlDB streams |
| List ksqlDB tables |
| Execute a ksqlDB statement |
| Execute a ksqlDB pull query |
ACLs
Tool | Description |
| List all ACLs for a cluster |
| Get ACLs for a specific principal |
Development
npm run build # Compile TypeScript
npm run dev # Watch modeLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables interaction with Apache Kafka topics, allowing users to publish messages to and read messages from Kafka instances through natural language.Apache 2.0
- Flicense-qualityDmaintenanceEnables AI assistants to manage and monitor Apache Kafka clusters through natural language, providing real-time operations, health monitoring, consumer lag analysis, and temporal trend detection for intelligent cluster management.
- Alicense-qualityCmaintenanceEnables AI agents to interact with Apache Kafka through natural language, supporting operations like producing/consuming messages, managing topics, and querying brokers, partitions, and consumer group offsets.1MIT
- Alicense-qualityDmaintenanceEnables interaction with Kafka clusters via MCP, supporting topic management (list, create, delete, inspect), connection initialization, and more through natural language.1Apache 2.0
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/seb-noirot/akhq-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server