InfluxDB MCP サーバー

InfluxDB OSS API v2を使用してInfluxDBインスタンスへのアクセスを公開するモデルコンテキストプロトコル（MCP）サーバー。主にClaude Codeによって構築されています。

特徴

この MCP サーバーは以下を提供します。

リソース: 組織、バケット、測定データへのアクセス
ツール: データの書き込み、クエリの実行、データベースオブジェクトの管理
プロンプト: 一般的な Flux クエリとラインプロトコル形式のテンプレート

リソース

サーバーは次のリソースを公開します。

組織リスト: influxdb://orgs
- InfluxDBインスタンス内のすべての組織を表示します
バケットリスト: influxdb://buckets
- すべてのバケットとそのメタデータを表示します
バケット測定: influxdb://bucket/{bucketName}/measurements
- 指定されたバケット内のすべての測定値を一覧表示します
クエリデータ: influxdb://query/{orgName}/{fluxQuery}
- Fluxクエリを実行し、結果をリソースとして返します

ツール

サーバーは次のツールを提供します:

write-data : 時系列データをラインプロトコル形式で書き込む
- パラメータ: org、bucket、data、precision（オプション）
query-data : Fluxクエリを実行する
- パラメータ: org、クエリ
create-bucket : 新しいバケットを作成する
- パラメータ: name、orgID、retentionPeriodSeconds（オプション）
create-org : 新しい組織を作成する
- パラメータ: 名前、説明（オプション）

プロンプト

サーバーは、次のプロンプトテンプレートを提供します。

flux-query-examples : 一般的な Flux クエリの例
line-protocol-guide : InfluxDB ラインプロトコル形式のガイド

構成

サーバーには次の環境変数が必要です:

INFLUXDB_TOKEN (必須): InfluxDB API の認証トークン
INFLUXDB_URL (オプション): InfluxDBインスタンスのURL (デフォルトはhttp://localhost:8086 )
INFLUXDB_ORG (オプション): 特定の操作のデフォルトの組織名

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の InfluxDB MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @idoru/influxdb-mcp-server --client claude

オプション1: npxで実行（推奨）

# Run directly with npx
INFLUXDB_TOKEN=your_token npx influxdb-mcp-server

オプション2: グローバルにインストールする

# Install globally
npm install -g influxdb-mcp-server

# Run the server
INFLUXDB_TOKEN=your_token influxdb-mcp-server

オプション3: ソースから

# Clone the repository
git clone https://github.com/idoru/influxdb-mcp-server.git
cd influxdb-mcp-server

# Install dependencies
npm install

# Run the server
INFLUXDB_TOKEN=your_token npm start

Claude for Desktopとの統合

claude_desktop_config.jsonにサーバーを追加します。

npx の使用（推奨）

{
  "mcpServers": {
    "influxdb": {
      "command": "npx",
      "args": ["influxdb-mcp-server"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

ローカルにインストールした場合

{
  "mcpServers": {
    "influxdb": {
      "command": "node",
      "args": ["/path/to/influxdb-mcp-server/src/index.js"],
      "env": {
        "INFLUXDB_TOKEN": "your_token",
        "INFLUXDB_URL": "http://localhost:8086",
        "INFLUXDB_ORG": "your_org"
      }
    }
  }
}

コード構造

サーバーコードはモジュール構造に編成されています。

src/
- index.js - メインサーバーのエントリポイント
- config/ - 設定関連ファイル
  - env.js - 環境変数の処理
- utils/ - ユーティリティ関数
  - influxClient.js - InfluxDB API クライアント
  - loggerConfig.js - コンソールロガーの設定
- handlers/ - リソースとツールのハンドラー
  - organizationsHandler.js - 組織の一覧
  - bucketsHandler.js - バケットの一覧
  - measurementsHandler.js - 測定値リスト
  - queryHandler.js - クエリ実行
  - writeDataTool.js - データ書き込みツール
  - queryDataTool.js - クエリツール
  - createBucketTool.js - バケット作成ツール
  - createOrgTool.js - 組織作成ツール
- prompts/ - プロンプトテンプレート
  - fluxQueryExamplesPrompt.js - Flux クエリの例
  - lineProtocolGuidePrompt.js - ラインプロトコルガイド

この構造により、保守性が向上し、テストが容易になり、関心の分離が明確になります。

テスト

リポジトリには、次のような包括的な統合テストが含まれています。

InfluxDB で Docker コンテナを起動する
サンプルデータを入力する
すべてのMCPサーバー機能をテストする

テストを実行するには:

npm test

ライセンス

マサチューセッツ工科大学

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Claude に InfluxDB 時系列データベースインスタンスへのアクセスを提供し、自然言語によるデータの書き込み、クエリ、組織およびバケットの管理を可能にするモデルコンテキストプロトコルサーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Database MCP Server
georgi-terziyski
-
security
-
license
-
quality
A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
Last updated -
Python
MCP Database Server
dwarvesf
-
security
F
license
-
quality
A Model Context Protocol server that provides tools for interacting with databases, including PostgreSQL, DuckDB, and Google Cloud Storage Parquet files.
Last updated -
2
TypeScript
InfluxDB MCP Server
m4tyn0
-
security
F
license
-
quality
A Model Context Protocol server that provides secure, read-only access to time-series data stored in InfluxDB 1.8 via JWT authentication.
Last updated -
Python
MCP Database Server
manpreet2000
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to interact with databases (currently MongoDB) through natural language, supporting operations like querying, inserting, deleting documents, and running aggregation pipelines.
Last updated -
TypeScript
MIT License

View all related MCP servers

InfluxDB MCP Server