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
);

可用工具

从文本中提取表格（无需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