TDengine クエリ MCP サーバー
AIアシスタント向けに読み取り専用のTDengineデータベースクエリを提供するモデルコンテキストプロトコル（MCP）サーバー。AI搭載ツールから直接クエリを実行し、データベース構造を探索し、データを調査できます。
サポートされているAIツール
この MCP サーバーは、次のようなモデル コンテキスト プロトコルをサポートする任意のツールで動作します。
カーソルIDE :
.cursor/mcp.jsonで設定アントロピック・クロード：互換性のあるMCPクライアントで使用
その他のMCP対応AIアシスタント: ツールのMCP設定手順に従ってください
Related MCP server: MCP MySQL App
機能と制限
何をするのか
✅読み取り専用の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 -huvxコマンドでインストール
uvx tdengine-mcp-server -hnpxコマンドで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 リポジトリで問題を報告してください。