mcp-server-scalardb
If you are the rightful owner of mcp-server-scalardb and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
ScalarDB Cluster 用の Model Context Protocol (MCP) サーバーです。このサーバーは、ScalarDB Cluster との対話を可能にするツールとリソースを提供します。
ScalarDB Cluster MCP Server
ScalarDB Cluster 用の Model Context Protocol (MCP) サーバーです。このサーバーは、ScalarDB Cluster との対話を可能にするツールとリソースを提供します。
機能
この MCP サーバーは以下の機能を提供します：
ツール
get_schema(namespace): 指定された名前空間のスキーマ情報を取得しますlist_namespaces(): 利用可能な名前空間の一覧を取得しますlist_tables(namespace): 指定された名前空間内のテーブル一覧を取得しますexecute_query(namespace, query): ScalarDB に対して SELECT クエリを実行しますexecute_transaction(namespace, statements): ScalarDB に対して複数のステートメント（INSERT, UPDATE, DELETE）をトランザクションとして実行します
インストール
詳細なインストール手順については、を参照してください。
必要な依存関係をインストールします：
pip install -r src/requirements.txt
使用方法
環境変数の設定
ScalarDB Cluster への接続には、以下の環境変数を設定する必要があります：
export SCALARDB_CLUSTER_ENDPOINT="localhost:60053"
開発モード
開発モードでサーバーを起動するには：
python src/main.py
または、提供されているスクリプトを使用：
./src/start_server.sh
Claude Desktop との統合
Claude Desktop でこのサーバーを使用するには、Claude Desktop の設定ファイルにこのサーバーを追加します。
MCP Inspector でのテスト
MCP Inspector を使用してサーバーをテストするには：
mcp dev src/main.py
実装の詳細
このサーバーは ScalarDB Cluster の gRPC API を使用して、データベースとの対話を行います。セキュリティ上の理由から、execute_query は SELECT クエリのみを許可し、execute_transaction は INSERT、UPDATE、DELETE ステートメントのみを許可します。
例
スキーマ情報の取得
# ツール: get_schema
# パラメータ:
# - namespace: "my_namespace"
名前空間の一覧取得
# ツール: list_namespaces
テーブルの一覧取得
# ツール: list_tables
# パラメータ:
# - namespace: "my_namespace"
クエリの実行
# ツール: execute_query
# パラメータ:
# - namespace: "my_namespace"
# - query: "SELECT * FROM users LIMIT 10"
トランザクションの実行
# ツール: execute_transaction
# パラメータ:
# - namespace: "my_namespace"
# - statements: [
# "INSERT INTO users (id, name) VALUES (1, 'Alice')",
# "UPDATE users SET age = 30 WHERE id = 1"
# ]
依存関係
主要な依存関係
- Python 3.8 以上
- MCP SDK 1.5.0 以上
- Uvicorn 0.27.0 以上
- Protobuf 5.29.3
- gRPC 1.60.0 以上
- gRPC Tools 1.60.0 以上
- uv 0.6.9 以上（高速なPythonパッケージマネージャー）
MCP SDKの依存関係（自動的にインストールされます）
- anyio 4.5 以上
- httpx 0.27 以上
- pydantic 2.7.2 以上
- starlette 0.27 以上
- その他の依存関係は
mcpパッケージをインストールすると自動的に解決されます
