TDengine クエリ MCP サーバー

AIアシスタント向けに読み取り専用のTDengineデータベースクエリを提供するモデルコンテキストプロトコル（MCP）サーバー。AI搭載ツールから直接クエリを実行し、データベース構造を探索し、データを調査できます。

サポートされているAIツール

この MCP サーバーは、次のようなモデルコンテキストプロトコルをサポートする任意のツールで動作します。

カーソルIDE : .cursor/mcp.jsonで設定
アントロピック・クロード：互換性のあるMCPクライアントで使用
その他のMCP対応AIアシスタント: ツールのMCP設定手順に従ってください

機能と制限

何をするのか

✅読み取り専用のTDengine クエリを実行する (SELECT、SHOW、DESCRIBE のみ)
✅ データベース/安定した情報とメタデータを提供する
✅ 利用可能なデータベースと厩舎を一覧表示する

できないこと

❌ 書き込み操作 (INSERT、UPDATE、DELETE、CREATE、ALTER など) を実行する
❌ データベース設計またはスキーマ生成機能を提供する
❌ 完全なデータベース管理ツールとして機能する

このツールは、読み取り専用クエリによるデータの調査と探索を目的として特別に設計されています。データベース管理、スキーマ管理、データ変更を目的としたものではありません。

使い方

ソースコードから実行

このMCPサーバーを使用する際の推奨方法は、インストールせずにuvで直接実行することです。以下の例では、Claude DesktopとCursorの両方でこの設定を使用しています。

リポジトリをクローンする場合:

git clone https://github.com/Abeautifulsnow/tdengine-mcp.git
cd tdengine-mcp

その後、サーバーを直接実行できます。

uv run src/tdengine_mcp_server -th 192.100.8.22 -db log -ll debug

あるいは、 src/tdengine_mcp_server/ディレクトリの.envファイルを変更して環境変数を設定し、次のコマンドでサーバーを実行することもできます。

uv run src/tdengine_mcp_server

重要: .env ファイルはコマンドライン引数よりも優先されます。

Pypiから`pip`コマンドでインストールする

# Install globally with pip
pip install tdengine_mcp_server

そして以下を実行します:

python -m tdengine_mcp_server -h

`uvx`コマンドでインストール

uvx tdengine-mcp-server -h

`npx`コマンドでsmitheryからインストール

npx -y @smithery/cli@latest install @Abeautifulsnow/tdengine-mcp --client cursor --config '"{}"'

--clientオプションの後に、 claude 、windsurf などの代替クライアントを指定できます。また、こちらもご参照ください: smithery/tdengine-mcp-server

設定オプション

.env ファイル

環境変数	説明	デフォルト
ログレベル	ログレベルを設定する（DEBUG、INFO、WARN、ERROR）	情報
TDENGINE_HOST	環境のデータベースホスト	ローカルホスト
TDENGINE_PORT	データベースポート	6041
TDENGINE_ユーザー名	データベースユーザー名	根
TDENGINE_パスワード	データベースパスワード	タオスデータ
TDENGINE_データベース	データベース名	ログ
TDENGINE_TIMEOUT	接続タイムアウトを秒単位で設定します	30
輸送	使用するトランスポートを制御する	標準入出力

CLI の使用法

$ python3 -m tdengine_mcp_server -h

usage: __main__.py [-h] [-th TAOS_HOST] [-tp TAOS_PORT] [-tu TAOS_USERNAME] [-pwd TAOS_PASSWORD] [-db TAOS_DATABASE] [-to TAOS_TIMEOUT] [-ll LOG_LEVEL]

TDengine MCP Server

options:
  -h, --help            show this help message and exit
  -th, --taos-host TAOS_HOST
                        TDengine host address. Default: `localhost`
  -tp, --taos-port TAOS_PORT
                        TDengine port number. Default: `6041`
  -tu, --taos-username TAOS_USERNAME
                        TDengine username. Default: `root`
  -pwd, --taos-password TAOS_PASSWORD
                        TDengine password. Default: `taosdata`
  -db, --taos-database TAOS_DATABASE
                        TDengine database name. Default: `default`
  -to, --taos-timeout TAOS_TIMEOUT
                        TDengine connection timeout. Default: `30`
  -ll, --log-level LOG_LEVEL
                        Log level. Default: `INFO`
  -trans, --transport {sse,stdio}
                        The transport to use. Default: `sse`

AIアシスタントとの統合

AIアシスタントはMCPサーバーを介してTDengineデータベースと連携できます。以下に例をいくつか示します。

クエリの例:

Can you use the query tool to show me the first 10 records from the database?

I need to analyze our sales data. Can you run a SQL query to get the total sales per region for last month from the development database?

Can you list all the available databases we have?

TDengine MCPツールの使用

TDengine Query MCP サーバーは、AI アシスタントが使用できる 3 つの主要なツールを提供します。

1. クエリ

特定のステーブルに対して読み取り専用の SQL クエリを実行します。

Use the query tool to run:

SELECT * FROM customers WHERE itemid > '2025-01-01' LIMIT 10;

2. 情報

厩舎の詳細情報を取得します。

Use the info tool to check the meta info about the specified stable.

DESCRIBE disks_info;

セキュリティに関する考慮事項

✅ 読み取り専用クエリのみが許可されます (SELECT、SHOW、DESCRIBE)

トラブルシューティング

接続の問題

接続に問題がある場合:

MCP構成でデータベースの資格情報を確認します
TDengineサーバーが稼働しておりアクセス可能であることを確認する
接続をブロックするファイアウォールルールを確認する
設定でLOG_LEVELを設定してデバッグモードを有効にします

よくあるエラー

エラー: クエリの実行に失敗しました

SQL構文を確認する
サポートされているクエリタイプ（SELECT、SHOW、DESCRIBE）のみを使用していることを確認してください
クエリが本当に読み取り専用であることを確認する

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

詳細情報やサポートが必要な場合は、GitHub リポジトリで問題を報告してください。

TDengine Query MCP Server

Integrations