greptimedb-mcp-server

Name: GreptimeDB MCP Server
Author: GreptimeTeam

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: MCP Toolkit

前提条件

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