greptimedb-mcp-server

👁 PyPI - バージョン
👁 ビルドワークフロー
👁 MITライセンス

GreptimeDB用のモデルコンテキストプロトコル (MCP) サーバー実装。

このサーバーは、AIアシスタントにデータベースを安全かつ構造化された方法で探索・分析する手段を提供します。制御されたインターフェースを介してテーブルの一覧表示、データの読み取り、SQLクエリの実行が可能になり、責任あるデータベースアクセスが確保されます。

プロジェクトのステータス

これはまだ開発中の実験的なプロジェクトです。データのセキュリティとプライバシーの問題については具体的に対処されていないため、慎重にご利用ください。

機能

• テーブルを一覧表示するにはlist_resources使用します

• テーブルデータを読み取るためのread_resource

• ツールを一覧表示するにはlist_tools使用します

• SQLを実行するためのcall_tool

• list_promptsはプロンプトを一覧表示します

• get_prompt名前でプロンプトを取得します

インストール

pip install greptimedb-mcp-server

構成

次の環境変数を設定します。

GREPTIMEDB_HOST=localhost # Database host
GREPTIMEDB_PORT=4002 # Optional: Database MySQL port (defaults to 4002 if not specified)
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public

またはコマンドライン引数経由:

• --hostデータベースホスト、デフォルトはlocalhost 、

• --portデータベースポート。MySQLプロトコルポートである必要があります。デフォルトでは4002 。

• --userデータベースのユーザー名。デフォルトでは空。

• --passwordデータベースのパスワード。デフォルトでは空です。

• --databaseデータベース名。デフォルトはpublic 。

使用法

クロードデスクトップ統合

Claude Desktop の構成ファイルで MCP サーバーを構成します。

macOS

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

ウィンドウズ

場所: %APPDATA%/Claude/claude_desktop_config.json

{
 "mcpServers": {
 "greptimedb": {
 "command": "uv",
 "args": [
 "--directory",
 "/path/to/greptimedb-mcp-server",
 "run",
 "-m",
 "greptimedb_mcp_server.server"
 ],
 "env": {
 "GREPTIMEDB_HOST": "localhost",
 "GREPTIMEDB_PORT": "4002",
 "GREPTIMEDB_USER": "root",
 "GREPTIMEDB_PASSWORD": "",
 "GREPTIMEDB_DATABASE": "public"
 }
 }
 }
}

ライセンス

MIT ライセンス - 詳細については LICENSE.md ファイルを参照してください。

貢献する

Related MCP server: SQLite MCP Server

前提条件

• uvパッケージ マネージャーを使用した Python

• GreptimeDBのインストール

• MCP サーバーの依存関係

発達

# Clone the repository
git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git
cd greptimedb-mcp-server

# Create virtual environment
uv venv
source venv/bin/activate # or `venv\Scripts\activate` on Windows

# Install development dependencies
uv sync

# Run tests
pytest

デバッグにはMCP Inspectorを使用します。

npx @modelcontextprotocol/inspector uv \
 --directory \
 /path/to/greptimedb-mcp-server \
 run \
 -m \
 greptimedb_mcp_server.server

了承

このライブラリの実装は、以下の 2 つのリポジトリからインスピレーションを受け、そのコードを組み込んでいます。感謝の意を表します。

• ktanaka101/mcp-server-duckdb

• デザインコンピュータ/mysql_mcp_server

• mikeskarl/mcp-prompt-templates

ありがとう！

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_dashboardC
• create_pipelineC
• delete_dashboardC
• delete_pipelineB
• describe_tableA
• dryrun_pipelineA
• execute_sqlA
• execute_tqlC