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

ライセンス

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

MCP Snowflake Service
datawiz168
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to execute SQL queries on Snowflake databases with automatic connection lifecycle management.
Last updated -
41
Python
MIT License
MCP Deep Web Research Server
PedroDnT
A
security
A
license
A
quality
A Model Context Protocol server that enables Claude to perform advanced web research with intelligent search queuing, enhanced content extraction, and deep research capabilities.
Last updated -
3
8
1
TypeScript
MIT License
Firestore Advanced MCP
diez7lm
-
security
A
license
-
quality
A Model Context Protocol server that enables large language models like Claude to perform comprehensive interactions with Firebase Firestore databases, supporting full CRUD operations, complex queries, and advanced features like transactions and TTL management.
Last updated -
2
4
JavaScript
MIT License
MCP SQL Server
JubinSaniei
-
security
F
license
-
quality
A Model Context Protocol server that allows Large Language Models like Claude to execute SQL queries, explore database schemas, and maintain persistent connections to SQL Server databases.
Last updated -
TypeScript

View all related MCP servers

InfluxDB MCP Server