hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

greptimedb-mcp-server

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 port (defaults to 4002 if not specified)
GREPTIMEDB_USER=root
GREPTIMEDB_PASSWORD=
GREPTIMEDB_DATABASE=public

またはコマンドライン引数経由:

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

使用法

クロードデスクトップ統合

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 ファイルを参照してください。

貢献する

前提条件

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

了承

このライブラリの実装は、以下の 2 つのリポジトリからインスピレーションを受け、そのコードを組み込んでいます。感謝の意を表します。

ありがとう！

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI アシスタントが GreptimeDB と安全に対話し、制御されたインターフェースを介してデータベーススキーマを探索し、データを読み取り、SQL クエリを実行できるようにするモデルコンテキストプロトコルサーバーの実装。

Related Resources

Reddit Discussion about this server

GreptimeDB MCP Server