timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Read-only Apache NiFi, ClickHouse and Kafka access with OIDC, audit and secret masking
この種の作業を AI に教える Skill。これと一緒に使えます
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 12/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
nifi-clickhouse-kafka-mcp をインストールして。https://mcp.popnx.com/i/arogan178-nifi-clickhouse-kafka-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
設定を 1 項目入力 (NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server nifi-clickhouse-kafka-mcp を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "nifi-clickhouse-kafka": { "command": "uvx", "args": [ "nifi-clickhouse-kafka-mcp" ], "env": { "NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、nifi-clickhouse-kafka-mcp のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG 設定ファイルのパスです。リポジトリ内の examples/config.example.yaml を参照してください。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"nifi-clickhouse-kafka": {
"command": "uvx",
"args": [
"nifi-clickhouse-kafka-mcp"
],
"env": {
"NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value"
}
}
}
}nifi-clickhouse-kafka-mcp を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が nifi-clickhouse-kafka-mcp を使っていると言うか、回答に nifi-clickhouse-kafka-mcp のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ nifi-clickhouse-kafka-mcp につなげません
nifi-clickhouse-kafka-mcp はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · nifi-clickhouse-kafka-mcp につなげるアプリを使う
B · データベース・データセット の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
設定を 1 項目入力 (NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server nifi-clickhouse-kafka-mcp を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user nifi-clickhouse-kafka --env NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG=your-value -- uvx nifi-clickhouse-kafka-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、nifi-clickhouse-kafka-mcp のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG 設定ファイルのパスです。リポジトリ内の examples/config.example.yaml を参照してください。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user nifi-clickhouse-kafka --env NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG=your-value -- uvx nifi-clickhouse-kafka-mcpnifi-clickhouse-kafka-mcp が一覧にあり、接続済みと表示されれば OK です
nifi-clickhouse-kafka-mcp を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が nifi-clickhouse-kafka-mcp を使っていると言うか、回答に nifi-clickhouse-kafka-mcp のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
設定を 1 項目入力 (NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server nifi-clickhouse-kafka-mcp を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "nifi-clickhouse-kafka": { "command": "uvx", "args": [ "nifi-clickhouse-kafka-mcp" ], "env": { "NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、nifi-clickhouse-kafka-mcp のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG 設定ファイルのパスです。リポジトリ内の examples/config.example.yaml を参照してください。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
nifi-clickhouse-kafka-mcp の設定で NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG が空です。自分のキーを入れて保存します
nifi-clickhouse-kafka-mcp を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が nifi-clickhouse-kafka-mcp を使っていると言うか、回答に nifi-clickhouse-kafka-mcp のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
設定を 1 項目入力 (NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server nifi-clickhouse-kafka-mcp を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "nifi-clickhouse-kafka": { "type": "stdio", "command": "uvx", "args": [ "nifi-clickhouse-kafka-mcp" ], "env": { "NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、nifi-clickhouse-kafka-mcp のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
uv --versionMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version
一度入れれば、uv を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG 設定ファイルのパスです。リポジトリ内の examples/config.example.yaml を参照してください。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
nifi-clickhouse-kafka-mcp の設定で NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG が空です。自分のキーを入れて保存します
nifi-clickhouse-kafka-mcp を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が nifi-clickhouse-kafka-mcp を使っていると言うか、回答に nifi-clickhouse-kafka-mcp のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code
claude mcp add --scope user nifi-clickhouse-kafka --env NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG=your-value -- uvx nifi-clickhouse-kafka-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"nifi-clickhouse-kafka": {
"command": "uvx",
"args": [
"nifi-clickhouse-kafka-mcp"
],
"env": {
"NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"nifi-clickhouse-kafka": {
"command": "uvx",
"args": [
"nifi-clickhouse-kafka-mcp"
],
"env": {
"NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"nifi-clickhouse-kafka": {
"type": "stdio",
"command": "uvx",
"args": [
"nifi-clickhouse-kafka-mcp"
],
"env": {
"NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG": "your-value"
}
}
}
}NIFI_CLICKHOUSE_KAFKA_MCP_CONFIG 必須 env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント arogan178 で確認済みです
コードの最終更新:6 日前
Apache-2.0を使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に nifi-clickhouse-kafka-mcp@0.1.0 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/arogan178-nifi-clickhouse-kafka-mcp)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は6 日前、最新バージョン(0.1.0)がレジストリに届いたのは32 日前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
同じカテゴリには:Supabase, Neon, DBCode, Keboola MCP, Dbmcp
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Official Neon MCP server for managing Neon projects and Lakebase Postgres databases.
Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...
Database MCP server for MySQL, MariaDB, PostgreSQL & SQLite with PII redaction and write-prevention
| これ nifi-clickhouse-kafka-mcp | Supabase | Neon | DBCode | Keboola MCP | Dbmcp | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドでもパソコンにインストールでも使える | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドでもパソコンにインストールでも使える | パソコンにインストールが必要 |
| キーが必要 | いいえ | はい | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | はい | はい | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 5/5 | 5/5 | 2/3 | 5/5 | 3/3 |
| ライセンス | Apache-2.0 | Apache-2.0 | MIT | NOASSERTION | MIT | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
A read-only MCP server that lets AI assistants look inside Apache NiFi, ClickHouse and Kafka: one server, every environment, and nothing it can break.
Ask Claude, Cursor or any MCP client things like:
nifi_health finds the full queue, the stopped processor and the error bulletin, worst first.nifi_queue, nifi_flowfile, nifi_provenance.kafka_consumer_lag flags partitions already behind retention.kafka_search by key, substring or JSON field.clickhouse_search_columns, clickhouse_describe_table.It grew out of a gateway built to give a data platform team AI access to NiFi 2, ClickHouse and Strimzi Kafka clusters without handing out credentials or write access.
flowchart LR
clients["MCP clients Claude Code, Claude Desktop, Cursor, VS Code, ..."] idp["OIDC provider Keycloak, Entra ID, Okta, ..."] gw[" nifi-clickhouse-kafka-mcp lock 1 ─── token + group check read-only tools request allowlist SQL parse check masking, size caps audit, metrics"] subgraph backends["Lock 2: read-only identities"] nifi["NiFi view-only policies"] ch["ClickHouse readonly user, SELECT grants"] kafka["Kafka Read/Describe ACLs"] end clients -- "stdio, or HTTP
Each environment (prod, staging, ...) has its own set of backends; one server serves them all.
| nifi-clickhouse-kafka-mcp | |
|---|---|
| Read-only, twice | Only read tools exist and only allowlisted requests are ever sent. Each backend identity is read-only too, so a bug in one lock is caught by the other. |
| Remote and multi-user | Streamable HTTP with OAuth tokens from any OIDC provider (Keycloak, Entra ID, Okta, Auth0, Dex), an optional group gate, and no credentials on laptops. Or plain stdio for one person. |
| Audited | One JSON line per call with the user, tool, arguments, outcome and size. ClickHouse queries carry the user into system.query_log. Optional Prometheus metrics. |
| Context-safe | Every list pages. ClickHouse streams and stops at a row or size cap and says so. A global result cap stops anything from flooding the model. |
| Masks secrets | Passwords, tokens, API keys and credentials in JSON, YAML, NDJSON, URLs and key=value text are masked in tool results, plus any field names you configure (emails, phone numbers). Binary payloads, which can't be masked, are withheld unless you allow them. |
| Many clusters | Named environments (prod, staging, ...), each with any mix of NiFi, ClickHouse and Kafka, behind one connector. |
| Leaves no trace | Kafka reads assign partitions directly: no consumer group is joined and no offset is committed. NiFi queue listings and provenance queries are deleted after use. |
See docs/landscape.md for how this compares with other NiFi, ClickHouse and Kafka MCP servers and which of their users' complaints it answers.
Try it against a local NiFi 2, ClickHouse and Kafka:
git clone https://github.com/arogan178/nifi-clickhouse-kafka-mcp && cd nifi-clickhouse-kafka-mcp/examples/demo
docker compose up -d # NiFi takes about a minute uv run --with requests python seed_nifi.py claude mcp add data -- uvx nifi-clickhouse-kafka-mcp --config "$PWD/config.yaml"
Then ask Claude Code "what's wrong in the demo NiFi flow?". examples/demo/README.md has the full walkthrough, including seeding Kafka.
For your own systems, write a config (see examples/config.example.yaml):
masked_fields: [email, phone]
environments: prod: nifi: url: https://nifi.example.com:8443 auth: {type: mtls, cert: /certs/mcp.pem, key: /certs/mcp.key} ca_bundle: /certs/ca.pem clickhouse: url: https://clickhouse.example.com:8443 user: mcp_reader password: ${CLICKHOUSE_PASSWORD} kafka: config: bootstrap.servers: kafka.example.com:9093 security.protocol: SASL_SSL sasl.mechanism: SCRAM-SHA-512 sasl.username: mcp-reader sasl.password: ${KAFKA_PASSWORD} schema_registry: {url: https://registry.example.com}
${VAR} and ${VAR:-default} read environment variables, so secrets stay out of the file. nifi-clickhouse-kafka-mcp --config config.yaml --check validates it and lists the tools it would serve.
One person, stdio. The server runs on your machine with your config:
claude mcp add data -- uvx nifi-clickhouse-kafka-mcp --config /path/to/config.yaml
{ "mcpServers": { "data": { "command": "uvx", "args": ["nifi-clickhouse-kafka-mcp", "--config", "/path/to/config.yaml"] } } }
A team, HTTP with OAuth. Run it once (Docker or Kubernetes), and everyone logs in with their own account:
claude mcp add --transport http --client-id nifi-clickhouse-kafka-mcp --callback-port 47130 data https://mcp.example.com/mcp
No identity provider? Put it behind the proxy you already have (oauth2-proxy, Cloudflare Access, Tailscale, ...) and set trusted_user_header to the header that proxy adds; the user still shows up in the audit log.
docs/deploying.md covers the identity provider, proxy mode, the read-only backend identities, Docker, Kubernetes, audit and metrics.
| System | Tools |
|---|---|
| All | environments |
| NiFi | nifi_health, nifi_status, nifi_flow_tree, nifi_search, nifi_process_group, nifi_component, nifi_processor_state, nifi_controller_services, nifi_bulletins, nifi_parameters, nifi_parameter, nifi_queue, nifi_flowfile, nifi_provenance, nifi_provenance_event |
| ClickHouse | clickhouse_query, clickhouse_databases, clickhouse_tables, clickhouse_describe_table, clickhouse_search_columns, clickhouse_health |
| Kafka | kafka_cluster, kafka_topics, kafka_describe_topic, kafka_consumer_groups, kafka_consumer_lag, kafka_sample, kafka_search |
Tools only appear for systems you configure. Turn any off with disabled_tools (patterns allowed, e.g. kafka_search or nifi_flow*).
Highlights:
{name:Type} parameters, streamed and cut at a row or size cap, with rows read and elapsed time. ClickHouse's own parser checks every statement first, and only table functions that read ClickHouse itself (numbers, merge, clusterAllReplicas, ...) may run; url, s3, file, remote and the rest are refused.resume token to continue.The gateway is the first lock. It registers only read tools (each annotated readOnlyHint). The NiFi client can only send GETs plus the temporary queue-listing and provenance requests NiFi needs, and refuses ids that would reach another endpoint. Every ClickHouse statement is parsed by ClickHouse (EXPLAIN AST) before it runs: only SELECT, WITH, SHOW, DESCRIBE, EXISTS and EXPLAIN pass, table functions must be on an allowlist wherever they appear, and the few scalar functions that reach the network or disk (hasColumnInTable, file, ...) are refused. Kafka is only ever read with assign(). Tests fail the build if a write path appears.
The backend is the second lock: give the gateway a NiFi identity with view-only policies, a ClickHouse user with readonly and SELECT grants, and a Kafka user with Read/Describe ACLs. docs/deploying.md has the exact setup for each.
Two choices worth knowing:
Report vulnerabilities as described in SECURITY.md.
uv sync
uv run pytest # unit tests docker compose -f examples/demo/compose.yaml up -d # then seed, see examples/demo/README.md NIFI_CLICKHOUSE_KAFKA_MCP_DEMO=1 uv run pytest tests/integration # end to end against real NiFi, ClickHouse, Kafka
Apache 2.0