AI导哈

SQL查询生成服务

OneSQL MCP Server是一款AI驱动的SQL查询生成和表格提取服务，支持自然语言转SQL、数据库模式管理以及文本表格提取功能。

  • by yicui2004
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yicui2004/onesql-mcp-server

使用说明

OneSQL MCP 服务器

OneSQL的模型上下文协议（MCP）服务器——基于AI的SQL查询生成与表提取工具。

特点/功能

  • SQL生成 （付费）：使用Qwen2.5-Coder-7B + OneSQL PEFT将自然语言转换为SQL查询
  • 模式管理 (付费功能)：上传、列出和删除数据库架构
  • 表格提取 (FREE): 从文本文档中提取表格 - 无需API密钥！

安装

快速安装

pip install onesql-mcp-server

手动安装

# Download the script
curl -O https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcp-server.py

# Make it executable
chmod +x onesql_mcp_server.py

设置

1. 获取API密钥

对于付费的SQL功能，请从以下位置获取您的API密钥：

  • AWS：https://aws.marketplace.amazon.com/pp/prodview-onesql（亚马逊云服务市场页面链接，可直接访问）
  • GCP（Google Cloud Platform）: 请联系 support@onekq.ai

2. 配置Claude桌面版

添加到你的 claude_desktop_config.json:

macOS（发音为“Mac OS”，全称为“Macintosh Operating System”，即苹果电脑操作系统）： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "onesql": {
      "command": "python",
      "args": ["/path/to/onesql_mcp_server.py"],
      "env": {
        "ONESQL_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. 重启Claude桌面版

OneSQL 工具将出现在 Claude Desktop 的工具列表中。

用法

免费表格提取（无需API密钥！）

Extract tables from this text:

| Name | Age | City |
|------|-----|------|
| John | 25  | NYC  |
| Jane | 30  | LA   |

SQL生成（需要API密钥）

Generate SQL to find all users who signed up in the last 30 days

首先，上传您的架构：

Upload my database schema:
CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  email VARCHAR(255),
  created_at TIMESTAMP
);

可用工具

工具 成本 描述
中文 英文 说明
💰 支付版 从自然语言生成SQL sql_upload_schema
💰 已付费 上传数据库架构以提高准确性 sql_list_schemas
💰 已付费 列出您保存的模式 sql_delete_schema
💰 付费 删除模式 extract_tables

从文本中提取表格（无需API密钥！）

Claude Desktop
    ↓
OneSQL MCP Server (local bridge)
    ↓
OneSQL GCP API
    ↓
├─ Schema Service (Firestore)
└─ SQL Generation (GPU - Qwen2.5-Coder-7B)

建筑学

  • 定价表格提取
  • 免费 - 无限使用，无需API密钥SQL生成
  • 通过AWS/GCP Marketplace按查询付费模式管理

随SQL订阅一同提供

API 端点

https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcp

MCP服务器连接到：

发展

export ONESQL_API_KEY="your-key"
python onesql_mcp_server.py

本地运行

服务器从标准输入（stdin）读取JSON-RPC请求，并将响应写入标准输出（stdout）。

npx @modelcontextprotocol/inspector python onesql_mcp_server.py

使用MCP Inspector进行测试

故障排除

  • “ONESQL_API_KEY”环境变量是必需的
  • 在Claude Desktop配置中设置环境变量（参见上方的设置步骤）

对于免费的表格提取，您可以使用占位符键或留空

  • “网络错误”/“超时”
  • 检查你的网络连接 curl https://us-central1-onekq-public.cloudfunctions.net/onesql-main/mcp

验证API端点是否可访问：

  • 工具未在Claude桌面版中显示
  • 配置更改后重启Claude桌面版

检查Claude Desktop日志中的错误

  • 支持
  • 问题：https://github.com/onekq/onesql-mcp-server/issues
  • 电子邮箱：support@onekq.ai

文档链接：https://docs.onekq.ai

许可证

MIT 许可证 - 详情请参见 LICENSE 文件

  • 链接
  • MCP协议：https://modelcontextprotocol.io
  • OneSQL: https://onekq.ai

相关 MCP