Skip to main content
Glama
deenesjakoruzh
Abeautifulsnow

TDengine Query MCP Server

by Abeautifulsnow
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

TDengine クエリ MCP サーバー

ライセンス: MIT 鍛冶屋のバッジ

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 -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)

トラブルシューティング

接続の問題

接続に問題がある場合:

  1. MCP構成でデータベースの資格情報を確認します

  2. TDengineサーバーが稼働しておりアクセス可能であることを確認する

  3. 接続をブロックするファイアウォールルールを確認する

  4. 設定でLOG_LEVELを設定してデバッグモードを有効にします

よくあるエラー

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

  • SQL構文を確認する

  • サポートされているクエリタイプ（SELECT、SHOW、DESCRIBE）のみを使用していることを確認してください

  • クエリが本当に読み取り専用であることを確認する

貢献

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

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

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
4moRelease cycle
2Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Abeautifulsnow/tdengine-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server