ScalarDB Cluster MCP Server

ScalarDB Cluster MCP Server

site icon
2025.03.29 0
Python数据库中间件ScalarDB 工具数据库
ScalarDB Cluster MCP Server 是一个为 ScalarDB Cluster 设计的 Model Context Protocol (MCP) 服务器,提供与 ScalarDB Cluster 交互的工具和资源。该服务器支持多种数据库操作,包括查询、事务处理以及元数据管理。
View on GitHub

Overview

基本能力

产品定位

ScalarDB Cluster MCP Server 是一个数据库中间件,用于简化与 ScalarDB Cluster 的交互,提供标准化的接口和工具集。

核心功能

  • 元数据管理:获取数据库的命名空间、表结构等元数据信息。
  • 数据查询:执行 SELECT 查询操作。
  • 事务处理:支持 INSERT、UPDATE、DELETE 等事务操作。
  • 工具集成:提供多种工具函数,便于开发和管理。

适用场景

  • 需要与 ScalarDB Cluster 交互的应用程序开发。
  • 数据库元数据管理和查询操作。
  • 需要执行复杂事务的应用场景。

工具列表

  • get_schema(namespace):获取指定命名空间的模式信息。
  • list_namespaces():列出所有可用的命名空间。
  • list_tables(namespace):列出指定命名空间中的所有表。
  • execute_query(namespace, query):执行 SELECT 查询。
  • execute_transaction(namespace, statements):执行事务操作(INSERT、UPDATE、DELETE)。

常见问题解答

  • 依赖问题:确保安装所有列出的依赖项,特别是 Python 3.8 及以上版本。
  • 连接问题:检查环境变量 SCALARDB_CLUSTER_ENDPOINT 是否正确设置。
  • 权限问题:确保服务器有足够的权限访问 ScalarDB Cluster。

使用教程

使用依赖

安装所有必要的依赖项:

pip install -r src/requirements.txt

安装教程

  1. 克隆项目仓库。
  2. 安装依赖项(如上所述)。
  3. 设置环境变量:
export SCALARDB_CLUSTER_ENDPOINT="localhost:60053"
  1. 启动服务器:
python src/main.py

或使用提供的脚本:

./src/start_server.sh

调试方式

使用 MCP Inspector 进行测试:

mcp dev src/main.py

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。