Tdengine MCP

🚀 TDengine 查询 MCP サーバ

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

🚀 クイックスタート

この MCP サーバは、AI アシスタントが TDengine データベースとやり取りするための読み取り専用のインターフェースを提供します。以下に、サーバの起動方法と使用例を示します。

✨ 主な機能

サポートされる AI ツール

この MCP サーバは、Model Context Protocol をサポートするあらゆるツールと互換性があります。以下にいくつかの例を挙げます：

• Cursor IDE：.cursor/mcp.json で設定します。
• Anthropic Claude：互換性のある MCP クライアントと一緒に使用します。
• その他の MCP 対応 AI アシスタント：ツールの MCP 設定手順に従ってください。

機能

• ✅ 読み取り専用 TDengine クエリ（SELECT、SHOW、DESCRIBE のみ）を実行します。
• ✅ データベース/安定情報とメタデータを提供します。
• ✅ 利用可能なデータベースと安定テーブルをリストします。

サポートされない機能

• ❌ 書き込み操作（INSERT、UPDATE、DELETE、CREATE、ALTER など）を実行しません。
• ❌ データベース設計やスキーマ生成機能を提供しません。
• ❌ 完全なデータベース管理ツールとして機能しません。

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

📦 インストール

ソースコードから実行

推奨 方法は、ソースコードから 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

⚠️ 重要提示

デフォルトでは、データベース名は default です。

pip を使用したインストール

Python パッケージを使用してインストールすることもできます：

pip install tdengine-mcp-server

その後、サーバを起動します：

tdengine-mcp-server --config your_config_file.yaml

💻 使用例

基本的な使用法

以下は、AI アシスタントがこの MCP サーバを使用して TDengine データベースを操作する例です。

サンプルクエリ

データベース内の最初の 10 件のレコードを表示するクエリを実行できますか？

販売データを分析する必要があります。開発データベースから先月の地域別の総売上を取得する SQL クエリを実行できますか？

利用可能なすべてのデータベースをリストできますか？

TDengine クエリ MCP ツールの使用

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

1. query

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

クエリツールを使用して以下のコマンドを実行します：

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

2. info

指定された安定テーブルの詳細情報を取得します：

info ツールを使用して指定された安定のメタデータを確認します。

DESCRIBE disks_info;

🔧 技術詳細

セキュリティに関する注意事項

• ✅ 読み取り専用のクエリ（SELECT、SHOW、DESCRIBE）のみを許可します。

トラブルシューティング

接続問題

接続問題が発生した場合は、以下の手順を実行してください：

1. MCP 設定でデータベースの資格情報を確認します。
2. TDengine サーバが実行中でアクセス可能であることを確認します。
3. ファイアウォール規則が接続をブロックしていないことを確認します。
4. デバッグモードを有効にし、設定で LOG_LEVEL を設定します。

一般的なエラー

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

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

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。

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

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、MIT ライセンス を参照してください。