Greptimedb MCP Server

🚀 greptimedb-mcp-server

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

✨ 主な機能

• 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 デスクトップ統合

Claude デスクトップの設定ファイルで 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 - 詳細は LICENSE.md ファイルを参照してください。

🔧 技術詳細

貢献

前提条件

• 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

謝辞

このライブラリの実装は、以下の 2 つのリポジトリのコードを参考にしています。これらのプロジェクトの貢献者の皆様に感謝いたします。

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