Greptimeteam Greptimedb MCP Server

🚀 GreptimeDB-MCP-Server

GreptimeDB用のモデルコンテキストプロトコル（MCP）を実装したサーバーです。このサーバーは、AIアシスタントに安全で構造化されたインターフェイスを提供し、データベースの探索と分析を可能にします。アシスタントは、テーブルの一覧表示、データの読み取り、SQLクエリの実行ができ、制御されたインターフェイスを通じて責任あるデータベースアクセスを保証します。

🚀 クイックスタート

このセクションでは、GreptimeDB-MCP-Serverの基本的な使い方を説明します。

📦 インストール

以下のコマンドを使用して、GreptimeDB-MCP-Serverをインストールします。

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"
      }
    }
  }
}

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSE.mdファイルを参照してください。

🔧 開発

前提条件

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

開発手順

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

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

# 開発用依存関係をインストール
pip install -r requirements-dev.txt

# テストを実行
pytest

デバッグ

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

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

👏 謝辞

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

• ktanaka101/mcp-server-duckdb
• designcomputer/mysql_mcp_server)