greptimedb-mcp-server
GreptimeDB用のモデルコンテキストプロトコル (MCP) サーバー実装。
このサーバーは、AIアシスタントにデータベースを安全かつ構造化された方法で探索・分析する手段を提供します。制御されたインターフェースを介してテーブルの一覧表示、データの読み取り、SQLクエリの実行が可能になり、責任あるデータベースアクセスが確保されます。
プロジェクトのステータス
これはまだ開発中の実験的なプロジェクトです。データのセキュリティとプライバシーの問題については具体的に対処されていないため、慎重にご利用ください。
機能
テーブルを一覧表示するには
list_resources使用しますテーブルデータを読み取るための
read_resourceツールを一覧表示するには
list_tools使用しますSQLを実行するための
call_toollist_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パッケージ マネージャーを使用した PythonGreptimeDBのインストール
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 つのリポジトリからインスピレーションを受け、そのコードを組み込んでいます。感謝の意を表します。
ありがとう！