SingleStore MCP Server

SingleStore MCP Server

site icon
2024.12.27 0
Python数据库中间件数据库安全访问数据库
SingleStore MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,用于安全地与 SingleStore 数据库进行交互。该服务器允许 AI 助手通过受控接口列出表、读取数据和执行 SQL 查询,使数据库探索和分析更加安全和结构化。
View on GitHub

Overview

基本能力

产品定位

SingleStore MCP Server 是一个数据库交互中间件,专门为 SingleStore 数据库设计,提供安全的数据库访问接口。

核心功能

  • 列出可用的 SingleStore 表作为资源
  • 支持多种数据格式(包括 BSON 和 JSON)读取表内容
  • 执行 SQL 查询并正确处理错误
  • 支持 SingleStore 特定的数据类型和函数
  • 通过环境变量实现安全的数据库访问
  • 全面的日志记录

适用场景

  • AI 助手需要安全访问 SingleStore 数据库
  • 需要结构化探索和分析数据库内容
  • 需要执行 SQL 查询并获取结果
  • 需要处理 SingleStore 特定的数据类型和函数

工具列表

  • singlestore-mcp-server: 主服务程序,提供数据库访问接口
  • uv: 用于运行服务的工具
  • pytest: 用于测试的工具

常见问题解答

  1. 如何配置数据库连接? 通过设置环境变量:SINGLESTORE_HOST, SINGLESTORE_PORT, SINGLESTORE_USER, SINGLESTORE_PASSWORD, SINGLESTORE_DATABASE

  2. 如何保证安全性?

  3. 创建专用的 SingleStore 用户并授予最小权限
  4. 不要使用管理员凭证
  5. 限制数据库访问
  6. 启用日志记录

使用教程

使用依赖

需要安装 Python 环境

安装教程

pip install singlestore-mcp-server

配置环境变量

SINGLESTORE_HOST=your_workspace_host
SINGLESTORE_PORT=3306  # Default SingleStore port
SINGLESTORE_USER=your_username
SINGLESTORE_PASSWORD=your_password
SINGLESTORE_DATABASE=your_database

调试方式

  1. 作为独立服务器运行
python -m singlestore_mcp_server
  1. 运行测试
pytest

许可证

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