InfluxDB 3
What it does
Official InfluxDB 3 MCP server: query, write and manage Core, Enterprise and Cloud databases.
- Connects パソコンで動く
- Account or key Needs INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN · 4 settings to fill in (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID)
- Category データベース・データセット
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 2/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
InfluxDB 3 に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
INFLUX_DB_PRODUCT_TYPEInfluxDB のエディションまたはサービス。そのランタイム設定値を使用します。英語の原文を見る
InfluxDB edition or service; use its runtime configuration value.INFLUX_DB_INSTANCE_URLInfluxDB の URL。Core、Enterprise、Cloud Serverless、Clustered では必須。例: Core または Enterprise の場合 http://localhost:8181/英語の原文を見る
InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.INFLUX_DB_ACCOUNT_IDCloud Dedicated で管理トークンを使用する場合は Account ID が必要です。英語の原文を見る
Account ID required when using a management token with Cloud Dedicated.INFLUX_DB_CLUSTER_IDCloud Dedicated で必要なクラスター ID。英語の原文を見る
Cluster ID required for Cloud Dedicated.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "influxdb3": { "command": "npx", "args": [ "-y", "@influxdata/influxdb3-mcp-server" ], "env": { "INFLUX_DB_PRODUCT_TYPE": "your-value", "INFLUX_DB_TOKEN": "your-value", "INFLUX_DB_INSTANCE_URL": "your-value", "INFLUX_DB_MANAGEMENT_TOKEN": "your-value", "INFLUX_DB_ACCOUNT_ID": "your-value", "INFLUX_DB_CLUSTER_ID": "your-value" } } } }キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude を終了してもう一度開く
試してみる
InfluxDB 3 を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が InfluxDB 3 を使っていると言うか、回答に InfluxDB 3 のツール名が出れば接続成功です
追加の設定 1 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
INFLUX_MCP_TOOL_PROFILE公開するツール。readonly は読み取り専用ツールのみ、readwrite は書き込みも許可、operator はすべてのツールを公開します。· 初期値 operator英語の原文を見る
Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ InfluxDB 3 につなげません
InfluxDB 3 はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · InfluxDB 3 につなげるアプリを使う
- InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
B · データベース・データセット の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Supabase✓ ChatGPT
- Appwrite MCP✓ ChatGPT
- Pg Aiguide✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
InfluxDB 3 に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
INFLUX_DB_PRODUCT_TYPEInfluxDB のエディションまたはサービス。そのランタイム設定値を使用します。英語の原文を見る
InfluxDB edition or service; use its runtime configuration value.INFLUX_DB_INSTANCE_URLInfluxDB の URL。Core、Enterprise、Cloud Serverless、Clustered では必須。例: Core または Enterprise の場合 http://localhost:8181/英語の原文を見る
InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.INFLUX_DB_ACCOUNT_IDCloud Dedicated で管理トークンを使用する場合は Account ID が必要です。英語の原文を見る
Account ID required when using a management token with Cloud Dedicated.INFLUX_DB_CLUSTER_IDCloud Dedicated で必要なクラスター ID。英語の原文を見る
Cluster ID required for Cloud Dedicated.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user influxdb3 --env INFLUX_DB_PRODUCT_TYPE=your-value --env INFLUX_DB_TOKEN=your-value --env INFLUX_DB_INSTANCE_URL=your-value --env INFLUX_DB_MANAGEMENT_TOKEN=your-value --env INFLUX_DB_ACCOUNT_ID=your-value --env INFLUX_DB_CLUSTER_ID=your-value -- npx -y @influxdata/influxdb3-mcp-serverEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude Code で /mcp と入力
InfluxDB 3 が一覧にあり、接続済みと表示されれば OK です
試してみる
InfluxDB 3 を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が InfluxDB 3 を使っていると言うか、回答に InfluxDB 3 のツール名が出れば接続成功です
追加の設定 1 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
INFLUX_MCP_TOOL_PROFILE公開するツール。readonly は読み取り専用ツールのみ、readwrite は書き込みも許可、operator はすべてのツールを公開します。· 初期値 operator英語の原文を見る
Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
InfluxDB 3 に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
INFLUX_DB_PRODUCT_TYPEInfluxDB のエディションまたはサービス。そのランタイム設定値を使用します。英語の原文を見る
InfluxDB edition or service; use its runtime configuration value.INFLUX_DB_INSTANCE_URLInfluxDB の URL。Core、Enterprise、Cloud Serverless、Clustered では必須。例: Core または Enterprise の場合 http://localhost:8181/英語の原文を見る
InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.INFLUX_DB_ACCOUNT_IDCloud Dedicated で管理トークンを使用する場合は Account ID が必要です。英語の原文を見る
Account ID required when using a management token with Cloud Dedicated.INFLUX_DB_CLUSTER_IDCloud Dedicated で必要なクラスター ID。英語の原文を見る
Cluster ID required for Cloud Dedicated.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
キーを入力
InfluxDB 3 の設定で INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN, INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Cursor の AI チャットを Agent モードで開く
試してみる
InfluxDB 3 を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が InfluxDB 3 を使っていると言うか、回答に InfluxDB 3 のツール名が出れば接続成功です
追加の設定 1 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
INFLUX_MCP_TOOL_PROFILE公開するツール。readonly は読み取り専用ツールのみ、readwrite は書き込みも許可、operator はすべてのツールを公開します。· 初期値 operator英語の原文を見る
Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
InfluxDB 3 のキーが必要です(提供元のサイトで作成) · 設定を 4 項目入力 (INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
InfluxDB 3 に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
設定を 4 項目入力
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
INFLUX_DB_PRODUCT_TYPEInfluxDB のエディションまたはサービス。そのランタイム設定値を使用します。英語の原文を見る
InfluxDB edition or service; use its runtime configuration value.INFLUX_DB_INSTANCE_URLInfluxDB の URL。Core、Enterprise、Cloud Serverless、Clustered では必須。例: Core または Enterprise の場合 http://localhost:8181/英語の原文を見る
InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.INFLUX_DB_ACCOUNT_IDCloud Dedicated で管理トークンを使用する場合は Account ID が必要です。英語の原文を見る
Account ID required when using a management token with Cloud Dedicated.INFLUX_DB_CLUSTER_IDCloud Dedicated で必要なクラスター ID。英語の原文を見る
Cluster ID required for Cloud Dedicated.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
キーを入力
InfluxDB 3 の設定で INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN, INFLUX_DB_PRODUCT_TYPE, INFLUX_DB_INSTANCE_URL, INFLUX_DB_ACCOUNT_ID, INFLUX_DB_CLUSTER_ID が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
VS Code の AI チャットを Agent モードで開く
試してみる
InfluxDB 3 を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が InfluxDB 3 を使っていると言うか、回答に InfluxDB 3 のツール名が出れば接続成功です
追加の設定 1 項目(入力しなくても使えます)
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
INFLUX_MCP_TOOL_PROFILE公開するツール。readonly は読み取り専用ツールのみ、readwrite は書き込みも許可、operator はすべてのツールを公開します。· 初期値 operator英語の原文を見る
Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user influxdb3 --env INFLUX_DB_PRODUCT_TYPE=your-value --env INFLUX_DB_TOKEN=your-value --env INFLUX_DB_INSTANCE_URL=your-value --env INFLUX_DB_MANAGEMENT_TOKEN=your-value --env INFLUX_DB_ACCOUNT_ID=your-value --env INFLUX_DB_CLUSTER_ID=your-value -- npx -y @influxdata/influxdb3-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"influxdb3": {
"command": "npx",
"args": [
"-y",
"@influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "your-value",
"INFLUX_DB_TOKEN": "your-value",
"INFLUX_DB_INSTANCE_URL": "your-value",
"INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
"INFLUX_DB_ACCOUNT_ID": "your-value",
"INFLUX_DB_CLUSTER_ID": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"influxdb3": {
"command": "npx",
"args": [
"-y",
"@influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "your-value",
"INFLUX_DB_TOKEN": "your-value",
"INFLUX_DB_INSTANCE_URL": "your-value",
"INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
"INFLUX_DB_ACCOUNT_ID": "your-value",
"INFLUX_DB_CLUSTER_ID": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"influxdb3": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@influxdata/influxdb3-mcp-server"
],
"env": {
"INFLUX_DB_PRODUCT_TYPE": "your-value",
"INFLUX_DB_TOKEN": "your-value",
"INFLUX_DB_INSTANCE_URL": "your-value",
"INFLUX_DB_MANAGEMENT_TOKEN": "your-value",
"INFLUX_DB_ACCOUNT_ID": "your-value",
"INFLUX_DB_CLUSTER_ID": "your-value"
}
}
}
}自分で入力する値
INFLUX_DB_PRODUCT_TYPE必須 envInfluxDB のエディションまたはサービス。そのランタイム設定値を使用します。英語の原文を見る
InfluxDB edition or service; use its runtime configuration value.INFLUX_DB_TOKEN秘密 必須 envオペレーター、管理者、リソース、またはデータベースのトークン。Core、Enterprise、Cloud Serverless では必須で、Cloud Dedicated と Clustered ではクエリ/書き込みに必要です。英語の原文を見る
Operator, admin, resource or database token. Required for Core, Enterprise and Cloud Serverless; needed for query/write on Cloud Dedicated and Clustered.INFLUX_DB_INSTANCE_URL必須 envInfluxDB の URL。Core、Enterprise、Cloud Serverless、Clustered では必須。例: Core または Enterprise の場合 http://localhost:8181/英語の原文を見る
InfluxDB URL. Required for Core, Enterprise, Cloud Serverless and Clustered; e.g. http://localhost:8181/ for Core or Enterprise.INFLUX_DB_MANAGEMENT_TOKEN秘密 必須 envCloud Dedicated または Clustered 用の管理 API トークン。完全な機能を使うには、これまたは INFLUX_DB_TOKEN、もしくは両方を指定してください。英語の原文を見る
Management API token for Cloud Dedicated or Clustered. Provide this or INFLUX_DB_TOKEN, or both for full functionality.INFLUX_DB_ACCOUNT_ID必須 envCloud Dedicated で管理トークンを使用する場合は Account ID が必要です。英語の原文を見る
Account ID required when using a management token with Cloud Dedicated.INFLUX_DB_CLUSTER_ID必須 envCloud Dedicated で必要なクラスター ID。英語の原文を見る
Cluster ID required for Cloud Dedicated.INFLUX_MCP_TOOL_PROFILEenv公開するツール。readonly は読み取り専用ツールのみ、readwrite は書き込みも許可、operator はすべてのツールを公開します。英語の原文を見る
Tools to expose. readonly exposes read-only tools; readwrite also allows writes; operator exposes all tools.
説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月14日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント influxdata で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:一昨日
- ! 注意
ライセンスがある
GitHubがライセンスの種類を判別できませんでした。ファイルを開いて確認してください
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
データベース・データセットのほかのサーバーとの比較i
- このカテゴリのほかの1194件のうち96%よりスターが多い
- このカテゴリのほかの1194件のうち72%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1194件のうち51%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
InfluxDB 3は安全ですか?
当てはまる基本チェック3項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:INFLUX_DB_TOKEN, INFLUX_DB_MANAGEMENT_TOKEN
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は一昨日、最新バージョン(2.0.1)がレジストリに届いたのは15 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases
同じカテゴリのほかの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
MCP Toolbox for Databases
MCP Toolbox for Databases enables your agent to connect to your database.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
InfluxDB 3 MCP Server
Model Context Protocol (MCP) server for InfluxDB 3 integration. Provides tools, resources, and prompts for interacting with InfluxDB 3 Core and Enterprise, plus InfluxDB Cloud Dedicated, InfluxDB Clustered, and InfluxDB Cloud Serverless via MCP clients.
Prerequisites
- InfluxDB 3 Instance: URL and token (Core/Enterprise/Cloud Serverless) or Cluster ID and tokens (Cloud Dedicated/Clustered)
- Node.js: 22.23.4 or a later 22.x, 24.22.1 or a later 24.x, or 26.12.1 or newer (for npm/npx usage)
- pnpm: use the version pinned in
package.jsonfor local development. Runcorepack enableto activate it. - Docker: (for Docker-based setup)
Node.js verifies TLS servers with a root certificate store built into the node binary. Earlier releases include roots that chain to compromised eMudhra/emSign intermediate CAs. The Docker image uses the latest Node.js 24 release. npm/npx installations use your local Node.js, so update it to a release listed above. Node.js 20 is end of life and has no fixed release.
Migrating to 2.0
Version 2.0 changes query result envelopes, health-check output, argument errors, and telemetry. Clients that parse these responses must follow the read-only output contract. Read metadata.completeness, caps, and warnings before treating query results as a complete answer. Discovery metadata states its source and leaves unavailable values unknown. Tool names and configured profiles remain available.
Read-only Agent Workflows
Set INFLUX_MCP_TOOL_PROFILE=readonly to give an MCP client tools that explore and query data. The profile leaves out every tool that writes data, administers databases, manages tokens, or runs on the host.
Credentials
Set INFLUX_DB_TOKEN to an admin token, a scoped token, or an Enterprise user-authentication JWT. The server sends it in a Bearer header without inspecting it, so the token's permissions decide which databases the tools can read.
Query arguments
query_sql and query_influxql accept database for db and query for q. A call that gives both names with different values fails with invalid_arguments. Every argument error is a structured tool error and is recorded in telemetry.
Discovery
list_databases returns what the server lists, with visibility: "unknown", because a listed database might still be unreadable. health_check returns JSON with separate health and ping outcomes. A scoped token can be denied both checks and still read its databases.
investigate_database keeps each table's result even when another table fails, and reports how many tables it saw and whether it stopped early. Samples come from a time window, 24 hours by default; set sampleWindowHours to change it. An empty window doesn't mean the table is empty. On Core and Enterprise, describe_table and investigation use system.influxdb_schema for authoritative column roles. They also read schema mode and deletion status from the _internal catalog when the same credential permits it, reporting source: "server" and the catalog table name. Unavailable values stay unknown; catalog denial does not discard readable column metadata or samples. Without authoritative deletion metadata, a table name with a timestamp-shaped suffix gets an advisory possibly_deleted warning and stays listed. Cardinality estimates aren't supported yet.
Errors
When a call fails, read error.code, error.recovery, and error.retryable:
- A
403isnot_found_or_denied. A token without access gets403whether or not the database exists. - A
404isnot_found. - A SQL query that names an unknown table has
recovery: "fix_reference". Calllist_tablesordescribe_tablefor the right name. - A query that runs out of server memory has
recovery: "narrow". - A query sent to an Enterprise ingest-only node has
recovery: "change_endpoint". - Other server failures have
recovery: "none".
EXPLAIN ANALYZE runs the query within the same bounds and adds a diagnostic_execution warning.
Analyst explores an unfamiliar database
An analyst can connect an MCP client such as Claude Desktop, Cursor, Codex, or another agent harness and ask a question like:
Which sensors had the highest average temperature in the last 24 hours?
With the read-only profile, the agent can:
- Call
list_databasesto see accessible databases. - Call
list_tablesanddescribe_tableto discover measurements and columns. - Treat uncertain tag and field categories as
unknown. - Build a bounded SQL query with
db,q, and optionalparams. - Call
query_sqlwith structured JSON output. - Return the result, row count, truncation status, warnings, and correlation metadata.
The user gets a grounded answer and a reusable query while the agent explores and queries data without access to mutation or administration tools.
Operator investigates an InfluxQL dashboard query
An operator can troubleshoot an existing InfluxQL dashboard panel and ask:
Why did this panel stop showing data after the deploy?
With the read-only profile, the agent can:
- Keep the user's query in InfluxQL and call
query_influxql. - Use
SHOWqueries and schema discovery to verify the measurement and referenced columns. - Sample recent rows with bounded reads to distinguish missing data from a broken query.
- Reject unsafe follow-up attempts, such as
SELECT INTOor destructive statements. - Return
request_id,query_id, andquery_id_sourceso the operator can correlate the MCP result withsystem.queries.idwhen query history is available. - Emit structured logs to stderr for stdio transports so stdout remains reserved for MCP protocol messages.
The user gets a practical diagnosis, such as missing data, renamed schema, a wrong time predicate, or a query failure. The investigation is traceable without logging full query text by default.
Available Tools
| Tool Name | Description | Availability |
|---|---|---|
load_database_context | Load optional custom database context and documentation | All versions |
get_help | Get help and troubleshooting guidance for InfluxDB operations | All versions |
write_line_protocol | Write data using InfluxDB line protocol | All versions |
create_database | Create a new database (with cloud-specific config options) | All versions |
update_database | Update database configuration (retention for all; maxTables/maxColumns for Cloud Dedicated/Clustered) | All versions |
delete_database | Delete a database by name (irreversible) | All versions |
execute_query | Deprecated since 2.0.0. Use query_sql. Retained for compatibility | All versions |
query_sql | Run bounded read-only SQL with structured response metadata | All versions |
query_influxql | Run bounded read-only InfluxQL with structured response metadata | All versions |
get_measurements | List all measurements (tables) in a database | All versions |
get_measurement_schema | Get schema (columns/types) for a measurement/table | All versions |
list_tables | List tables, also called measurements, in a database | All versions |
describe_table | Describe table schema with conservative column categories | All versions |
investigate_database | Run high-level read-only database discovery and sampling | All versions |
create_admin_token | Create a named admin token with an optional expiration | Core/Enterprise only |
list_admin_tokens | List all admin tokens (with optional filtering) | Core/Enterprise only |
create_resource_token | Create a resource token for specific DBs and permissions | Enterprise only |
list_resource_tokens | List all resource tokens (with filtering and ordering) | Enterprise only |
delete_token | Delete a token by name | Core/Enterprise only |
regenerate_operator_token | Regenerate the operator token (dangerous/irreversible) | Core/Enterprise only |
cloud_list_database_tokens | List all database tokens for Cloud-Dedicated/Clustered cluster | Cloud Dedicated/Clustered |
cloud_get_database_token | Get details of a specific database token by ID | Cloud Dedicated/Clustered |
cloud_create_database_token | Create a new database token for Cloud-Dedicated/Clustered cluster | Cloud Dedicated/Clustered |
cloud_update_database_token | Update an existing database token | Cloud Dedicated/Clustered |
cloud_delete_database_token | Delete a database token from Cloud-Dedicated/Clustered cluster | Cloud Dedicated/Clustered |
list_databases | List all available databases in the instance | All versions |
health_check | Check InfluxDB connection and health status | All versions |
Available Resources
| Resource Name | Description |
|---|---|
influx-config | Read-only access to InfluxDB configuration |
influx-status | Real-time connection and health status |
| influx-databases | List of all databases in the instan