Greptimedb

🚀 greptimedb-mcp-server

このサーバーは、GreptimeDB 用に実装された Model Context Protocol (MCP) サーバーです。AI アシスタントに対し、データベースを探索および分析するための安全で構造化されたインターフェースを提供します。アシスタントは、このインターフェースを通じて、テーブルの一覧表示、データの読み取り、SQL クエリの実行を行うことができ、責任あるデータベースアクセスが可能となります。

🚀 クイックスタート

このサーバーは、AI アシスタントが GreptimeDB データベースを安全に操作するためのインターフェースを提供します。以下の手順でセットアップして使用できます。

✨ 主な機能

• list_resources：テーブルを一覧表示します。
• read_resource：テーブルのデータを読み取ります。
• list_tools：ツールを一覧表示します。
• call_tool：SQL を実行します。
• list_prompts：プロンプトを一覧表示します。
• get_prompt：名前に基づいてプロンプトを取得します。

📦 インストール

pip install greptimedb-mcp-server

📚 ドキュメント

設定

以下の環境変数を設定することができます。

GREPTIMEDB_HOST=localhost    # データベースホスト
GREPTIMEDB_PORT=4002         # オプション：データベースポート（デフォルトは 4002、指定されない場合はこの値が使用されます）
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public

または、コマンドライン引数を使用することもできます。

• --host：データベースホスト
• --port：データベースポート
• --user：データベースユーザー名
• --password：データベースパスワード
• --database：データベース名

使用方法

Claude Desktop との統合

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

MacOS

設定ファイルの位置：~/Library/Application Support/Claude/claude_desktop_config.json

Windows

設定ファイルの位置：%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"
      }
    }
  }
}

開発

前提条件

• uv パッケージマネージャー付きの Python
• GreptimeDB のインストール
• MCP サーバーの依存関係

手順

# リポジトリをクローン
git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git
cd greptimedb-mcp-server

# 仮想環境を作成
uv venv
source venv/bin/activate  # または Windows では `venv\Scripts\activate`

# 開発用の依存関係をインストール
uv sync

# テストを実行
pytest

MCP Inspector を使用してデバッグすることができます。

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

📄 ライセンス

MIT License - 詳細は LICENSE.md ファイルを参照してください。

👏 謝辞

このライブラリの実装には、以下のリポジトリのコードを参考にさせていただきました。感謝いたします。

• ktanaka101/mcp-server-duckdb
• designcomputer/mysql_mcp_server
• mikeskarl/mcp-prompt-templates