SQLReader

xperiamol/SQLReader

Hosted

3 Stars 1.4k 次浏览更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "gradio": {
      "args": [
        "mcp-remote",
        "https://xperiamol-sqlreader.ms.show/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ],
      "command": "npx"
    }
  }
}

服务介绍

NaturalSQL MCP Server

这是一个基于 Model Context Protocol (MCP) 的自然语言 SQL 查询服务器。

功能特性

🧠 自然语言转 SQL 查询
🔗 动态数据库连接配置
🛡️ SQL 安全检查（阻止危险操作）
📊 结果数据表格展示
🌐 基于 Gradio 的 Web 界面

安装依赖

pip install -r requirements.txt

启动方式

方式1：直接启动

python app.py

方式2：使用批处理文件（Windows）

start_mcp_server.bat

MCP 配置文件

mcp_config.json - 简单的 MCP 服务器配置
mcp_server_config.json - 详细的 MCP 服务器配置，包含工具定义

使用说明

配置数据库连接
- 在"数据库配置"标签页中输入 PostgreSQL 连接信息
- 点击"测试连接"验证连接
- 点击"更新配置"应用配置并加载数据库架构
执行自然语言查询
- 切换到"SQL查询"标签页
- 输入自然语言查询，例如："查看2023年7月的订单总金额"
- 点击"执行查询"获取结果

安全特性

系统会自动检测并阻止以下危险 SQL 操作：

DROP
DELETE
TRUNCATE
UPDATE
INSERT

环境要求

Python 3.8+
PostgreSQL 数据库
OpenAI API 密钥（需在 config.py 中配置）

配置 OpenAI API

在 config.py 文件中设置您的 OpenAI API 密钥：

openai_api_key = "your-openai-api-key-here"

查看源码项目主页