SingleStore MCP 服务器

一个支持安全交互的 SingleStore 数据库模型上下文协议（MCP）服务器。此服务器允许 AI 助手列出表格、读取数据以及通过受控接口执行 SQL 查询，从而实现数据库探索和分析的安全性和结构化。

特性

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

安装

pip install singlestore-mcp-server

配置

设置以下环境变量：

SINGLESTORE_HOST=your_workspace_host
SINGLESTORE_PORT=3306  # SingleStore 的默认端口
SINGLESTORE_USER=your_username
SINGLESTORE_PASSWORD=your_password
SINGLESTORE_DATABASE=your_database

使用方法

在 Claude Desktop 中使用

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "singlestore": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/singlestore_mcp_server",
        "run",
        "singlestore_mcp_server"
      ],
      "env": {
        "SINGLESTORE_HOST": "your_workspace_host",
        "SINGLESTORE_PORT": "3306",
        "SINGLESTORE_USER": "your_username",
        "SINGLESTORE_PASSWORD": "your_password",
        "SINGLESTORE_DATABASE": "your_database"
      }
    }
  }
}

作为独立服务器运行

# 安装依赖项
pip install -r requirements.txt

# 运行服务器
python -m singlestore_mcp_server

开发

# 克隆仓库
git clone https://github.com/yourusername/singlestore_mcp_server.git
cd singlestore_mcp_server

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 或 `venv\Scripts\activate` 在 Windows 上

# 安装开发依赖项
pip install -r requirements-dev.txt

# 运行测试
pytest

SingleStore 特定功能

• 支持 BSON 数据类型和操作
• 原生 JSON 处理，支持 SingleStore 的 JSON 函数
• 支持 SingleStore Kai（MongoDB API 兼容性）
• 正确处理 SingleStore 特定的数据类型

安全注意事项

• 永远不要提交环境变量或凭证
• 使用权限最小的数据库用户
• 考虑在生产环境中实施查询白名单
• 监控和记录所有数据库操作

安全最佳实践

此 MCP 服务器需要数据库访问权限才能运行。为了安全起见：

1. 创建一个专用的 SingleStore 用户，赋予最小权限
2. 避免将敏感凭证硬编码到配置文件或代码中
3. 定期审查和更新访问策略以确保安全性
4. 启用审计日志以监控数据库活动

如需详细了解安全建议，请参考 SingleStore 安全指南。

许可证

项目遵循 LICENSE 协议，具体内容请参阅相关文件。

贡献指南

如果希望为该项目做出贡献，请参考 CONTRIBUTING.md 文件了解详细信息。我们欢迎您提出的改进和修复！