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の両方でこの設定を使用しています。
リポジトリをクローンする場合:
その後、サーバーを直接実行できます。
あるいは、 src/tdengine_mcp_server/ディレクトリの.envファイルを変更して環境変数を設定し、次のコマンドでサーバーを実行することもできます。
重要: .env ファイルはコマンドライン引数よりも優先されます。
Pypiからpipコマンドでインストールする
そして以下を実行します:
uvxコマンドでインストール
npxコマンドでsmitheryからインストール
--clientオプションの後に、 claude 、windsurf などの代替クライアントを指定できます。また、こちらもご参照ください: smithery/tdengine-mcp-server
設定オプション
.env ファイル
環境変数 | 説明 | デフォルト |
ログレベル | ログレベルを設定する（DEBUG、INFO、WARN、ERROR） | 情報 |
TDENGINE_HOST | 環境のデータベースホスト | ローカルホスト |
TDENGINE_PORT | データベースポート | 6041 |
TDENGINE_ユーザー名 | データベースユーザー名 | 根 |
TDENGINE_パスワード | データベースパスワード | タオスデータ |
TDENGINE_データベース | データベース名 | ログ |
TDENGINE_TIMEOUT | 接続タイムアウトを秒単位で設定します | 30 |
輸送 | 使用するトランスポートを制御する | 標準入出力 |
CLI の使用法
AIアシスタントとの統合
AIアシスタントはMCPサーバーを介してTDengineデータベースと連携できます。以下に例をいくつか示します。
クエリの例:
TDengine MCPツールの使用
TDengine Query MCP サーバーは、AI アシスタントが使用できる 3 つの主要なツールを提供します。
1. クエリ
特定のステーブルに対して読み取り専用の SQL クエリを実行します。
2. 情報
厩舎の詳細情報を取得します。
セキュリティに関する考慮事項
✅ 読み取り専用クエリのみが許可されます (SELECT、SHOW、DESCRIBE)
トラブルシューティング
接続の問題
接続に問題がある場合:
MCP構成でデータベースの資格情報を確認します
TDengineサーバーが稼働しておりアクセス可能であることを確認する
接続をブロックするファイアウォールルールを確認する
設定で
LOG_LEVELを設定してデバッグモードを有効にします
よくあるエラー
エラー: クエリの実行に失敗しました
SQL構文を確認する
サポートされているクエリタイプ（SELECT、SHOW、DESCRIBE）のみを使用していることを確認してください
クエリが本当に読み取り専用であることを確認する
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
詳細情報やサポートが必要な場合は、GitHub リポジトリで問題を報告してください。